The Arsenal Files 2/The Arsenal Files 2 (Arsenal Computer).ISO/os2/tcp20c4.exe/LAMAILC2.ZIP/HELP/lamail.hlp

OS/2 Help File | 1994-03-08 | 142.4 KB | 5,145 lines

ΓòÉΓòÉΓòÉ 1. LaMail Extended Help ΓòÉΓòÉΓòÉ

LaMail's Extended Help provides help for the following:

o Introduction to LaMail

o LaMail Setup

o LaMail's Commands

   - Main Application menu
   - Configuration menu
   - accelerator keys
   - mouse actions.

o LaMail's Note Editor

   - Viewing and Writing notes.
   - Configuring Note options.
   - Mail related commands.
   - General LaMail Note Editor help.

o Handling Nicknames


ΓòÉΓòÉΓòÉ 2. LaMail Editor Commands ΓòÉΓòÉΓòÉ

LaMail's edit component supports a variety of general purpose editing commands.
Many of the most common commands are accessible on the editor's menu, and ALL
of the editor's commands can be invoked from the command dialog window.  The
user may pop-up the command dialog window by pressing the Esc key or by
selecting the "Command dialog..."  menu item in the "Command" menu.

o [#](Go To Line)
o ALL (Find All Text)
o ADD (Add Block)
o BOTTOM (Go To Bottom)
o BOX (Box Mark)
o CD (Change Directory)
o CENTER (Center Mark)
o CHANGE (Change Text)
o CUT (Cut Text)
o DIR (Directory List)
o DRAW (Draw Text Graphics)
o EDIT (Edit File)
o FILE (Save & Quit)
o FILL (Fill Mark)
o LOCATE (Locate Text)
o MARGINS (Set Text Margins)
o MATHx (Calculate)
o MULT (Multiply Block)
o NAME (Rename Current File)
o OPEN (Open New Edit Window)
o OS2 (Execute OS/2 Command)
o PASTE (Paste Text)
o PRINT (Print File)
o QD (Query Date)
o QT (Query Time)
o SAVE (Save File)
o SORT (Sort File)
o TABS (Set Tab Stops)
o TOP (Go To Top)


ΓòÉΓòÉΓòÉ 3. Introduction ΓòÉΓòÉΓòÉ

LaMail is an electronic mail handling system that is used in conjunction with
the Sendmail mail delivery system.  LaMail is an IBM Presentation Manager
application that allows a user to view mail, write notes, and save mail in mail
folders.

Using standard PM controls (re-sizeable windows, pull-down menus, and
listboxes), LaMail allows a user to interact with electronic mail in a quick
and organized manner.

LaMail gives the user the ability to organize mail into folders. A folder is a
collection of mail files that share some common attribute, such as userid,
location, or subject.  A Sendmail InBasket folder is automatically defined to
represent incoming mail delivered by the Sendmail application.


ΓòÉΓòÉΓòÉ 4. Setup ΓòÉΓòÉΓòÉ

Properly setting up your system to run LaMail depends on the location of the
files which it uses while operating.  For more information, see the following
sections:

o Files
o Directory structure
o Application Options
o Running LaMail


ΓòÉΓòÉΓòÉ 4.1. Files ΓòÉΓòÉΓòÉ

The LaMail system consists of the following files:

File      Description

LAMAIL.EXE The LaMail application.  The file LAMAIL.EXE must be in the current
          directory, prefixed by a path name, or in a directory specified in
          the PATH environment variable.  By default, LAMAIL.EXE is placed in
          the \TCPIP\BIN directory.

FIC.DLL, LAM551E.DLL, LAM551R.DLL, NICK16.DLL, and LAMRES.DLL Dynamic link
          libraries used by the LaMail application.  Dynamic link libraries
          must be located in a directory specified in the LIBPATH environment
          variable.  (See the "SET LIBPATH" statement in the CONFIG.SYS file
          located in the root directory of your boot drive.) By default, the
          above dynamic link libraries are placed in the \TCPIP\DLL directory.

LAMAIL.CF and custom .CFG files. LaMail configuration files.  The LaMail
          configuration files are used internally by LaMail and must be located
          either in the directory from which LaMail is being executed, in a
          directory specified in the DPATH environment variable, or in a
          directory specified in the LAMPATH environment variable.  By default,
          these files are placed in the \TCPIP\LAMAIL directory.

MAILLIST.EX, EPMLIST.EX, E3EMUL.EX, EXTRA.EX, PUT.EX, GET.EX, MATHLIB.EX,
BOX.EX, DRAW.EX, EPMLEX.EX, MATHLIB.EX, EPM.EX, LAMEXTRA.EX and HELP.EX. LaMail
          support code.  The LaMail support code is used internally by LaMail.
          The .EX files must be located in the directory from which LaMail is
          being executed, in a directory specified along the DPATH environment
          variable, or in a directory specified in the LAMPATH environment
          variable.  By default, these files are placed in the \TCPIP\BIN
          directory.

LAMAIL.HLP LaMail Help Manager file.  This help file contain the data needed to
          present LaMail help.  The help file must be placed in a directory
          specified within the HELP environment variable.  (See the "SET HELP"
          statement in the CONFIG.SYS file located in the root directory of
          your boot drive.)  By default, this file is placed in the \TCPIP\DOC
          directory.


ΓòÉΓòÉΓòÉ 4.2. Directory Structure ΓòÉΓòÉΓòÉ

LaMail uses three directories:  a directory where incoming mail is placed by
Sendmail; a directory where LaMail stores folders; and a directory where
outgoing mail is placed to be sent by Sendmail.

The default Sendmail configuration suggests the existence of two directories
named \TCPIP\ETC and \TCPIP\ETC\MAIL . Within \TCPIP\ETC\MAIL is an index file
- called INBOX.NDX - containing summaries of all incoming mail, located in the
same directory.

LaMail allows the user to receive mail from the \TCPIP\ETC\MAIL directory to
another directory, called a folder.  By default, LaMail creates a directory
called \TCPIP\LAMAIL from which other directories are created to represent the
individual folders.  For example, if a note is received into the folder named
OLDMAIL, the following directories would automatically be created by LaMail:

\TCPIP\LAMAIL                 LaMail base directory.  This directory will
                              contain an index file for each folder that
                              exists.  In the above example, a file named
                              OLDMAIL.NDX will be created and placed in this
                              directory.

\TCPIP\LAMAIL\OLDMAIL         LaMail folder directory.  This directory will
                              contain all mail files received to the OLDMAIL
                              folder.

When mail is being sent by LaMail, a directory named \TCPIP\LAMAIL\OUT is
created.  This directory contains all out going mail and is known as the OutBox
folder.


ΓòÉΓòÉΓòÉ 4.3. Application Options ΓòÉΓòÉΓòÉ

Once LaMail is running you can change any various options and the default
directory settings by selecting the Set Application Options choice under the
Options pull-down. A panel is displayed containing the various options,
directory fields and their current values. The options and their meaning are as
follows:

View mail by folder in one window Whether all mail should be viewed in one
                              window. If checked, every time you view a note it
                              will be loaded into the existing View window. (If
                              one does not exist, a new one will be created.)
                              Loading a note into an existing window is faster
                              than forcing creation of a new window.

                              If not checked, then every time you execute a
                              View, the file or set of files will be loaded
                              into a new window.

Fast browse mode              When turned on, every time the block cursor moves
                              to a new file in the folder window, that file
                              will be loaded into the view window. Checking
                              this option forces Edit all in one.

Keep window size ratio        This determines whether any open folder windows
                              should be resized proportionally whenever the
                              main LaMail window is resized.

Beep on new mail              Selects whether or not LaMail beeps when new mail
                              is found in the InBasket.

Restore on new mail           Selects whether or not the LaMail window should
                              be restored if it is minimized and new mail is
                              found in the InBasket.

The directory fields and their meaning are as follows:

*.EX files          The path which should be searched for the .ex files used by
                    LaMail. This will generally be set by the TCP/IP
                    installation program. Multiple subdirectories may be
                    listed, separated by semicolons. The default value is
                    \TCPIP\BIN. This should also contain the path to Sendmail.

Config file         This is where LaMail will save the LAMAIL.CF and *.CFG
                    configuration files when you select Configure from the
                    Folders pull-down. The default value is \TCPIP\LAMAIL.

Temp files          This is where LaMail will create any temporary files it
                    needs to use. It should be placed on a virtual disk, if you
                    have one defined with free space on it, otherwise it should
                    point to a \temp subdirectory (so you can easily erase all
                    the files in it when necessary). The default value is
                    \TCPIP\TMP.

Folders             The directory in which the folder directories and
                    corresponding index and icon files (except for the Sendmail
                    InBasket) will be created and looked for. The default value
                    is \TCPIP\LAMAIL.

In basket           The directory where new mail will be looked for. This
                    should be the subdirectory listed in the Mlocal statement
                    in your SENDMAIL.CF file. The default value is
                    \TCPIP\ETC\MAIL.


ΓòÉΓòÉΓòÉ 4.4. Running LaMail ΓòÉΓòÉΓòÉ

To run LaMail, type:

  LAMAIL

from the OS/2 command line.  This will begin a LaMail session.  You will see a
message appear during initialization, after which the LaMail application window
will be displayed.

(Note:  It is assumed that INET and SENDMAIL are running. LaMail will run if
INET and SENDMAIL are not running, but mail will not be received or sent)


ΓòÉΓòÉΓòÉ 5. Executing LaMail Commands ΓòÉΓòÉΓòÉ

By using LaMail's action bar, you can execute any LaMail command.

If you are using a mouse, clicking on the appropriate menu will display the
pull-down.  You may then select the command that you wish to execute.

If you are using the keyboard, pressing F10 will select the action bar. You can
then use the left/right arrow keys to select a menu, then the up/down arrow
keys to select a command to execute.

The pull-down menus and a brief description of each command in each choice are
found in the section LaMail Main Action Bar.


ΓòÉΓòÉΓòÉ 6. LaMail Main Action Bar ΓòÉΓòÉΓòÉ

The command menus allow you to manipulate your mail in various ways.  For a
brief description of the commands in each of the action bar pull-downs, see the
following sections:

o Notes
o Folders
o Options
o Transfer
o Help
o Exit


ΓòÉΓòÉΓòÉ 6.1. Notes ΓòÉΓòÉΓòÉ

This pull-down contains commands which deal with reading and creating notes.

Pull-down selection           Description

View                          for viewing notes.

Move                          for moving notes between folders. (This appears
                              as Receive when the active folder is the Host
                              Reader.)

Discard                       for discarding notes.

Print                         for printing notes.

Archive                       for archiving notes

Create Note... (Alt+N)        Starts a new note

Mark All (Alt+M)              marks all notes for further action.

Unmark All (Alt+U)            unmarks all notes.

Inverse Mark (Alt+I)          Marks unmarked items and unmarks marked items.

List windows... (Alt+W)       Displays a list of all LaMail edit windows

Edit a file... (Alt+E)        Pops up the Open File dialog box, to let you edit
                              an arbitrary file. This will only appear under
                              Notes if LaMail was started with the /hacker
                              option, however the accelerator key (Alt+E) will
                              work in any case.


ΓòÉΓòÉΓòÉ 6.1.1. View ΓòÉΓòÉΓòÉ

Pull-right selection          Description

Current (Alt+F1)              Views the current note

All Marked (Shift+Alt+F1)     Views all marked notes

All                           Views all notes in the active folder


ΓòÉΓòÉΓòÉ 6.1.2. Move ΓòÉΓòÉΓòÉ

Pull-right selection          Description

Current to default (Alt+F2)   Moves the current note into the default folder

Current to...                 Moves current note into a different folder.

All Marked to default (Shift+Alt+F2) Moves all marked notes into the default
                              folder.

All Marked to...              Moves all marked notes into a different folder.
                              The user will be prompted for a folder name.

                              The above items allow a user to move mail into a
                              folder. The move function can be executed against
                              either the current note (with the box cursor
                              surrounding it), or the marked notes.

                              In cases where the default folder is used, the
                              default folder is determined in the following
                              manner:

   o The nicknames file is searched for the userid and node of the sender and,
     if found, the folder associated with the sender is used.

   o If a matching entry does not exist, or a folder is not associated with the
     matching entry, then the value entered on the LaMail Note Options panel is
     used.

   o If the above two do not apply, then "ALL" is used for the default folder.


ΓòÉΓòÉΓòÉ 6.1.3. Move/Receive Dialog ΓòÉΓòÉΓòÉ

This dialog lets you select the folder or notebook to which the selected note
or notes will be moved or received. You can enter a folder name in the entry
field, or press the "drop-down" arrow to the right of the entry field to select
from a list of all your existing folders.


ΓòÉΓòÉΓòÉ 6.1.4. Discard ΓòÉΓòÉΓòÉ

Pull-right selection          Description

Current (Alt+F3)              Deletes the current note

All Marked (Shift+Alt+F3)     Deletes all marked notes

                              Because there can be many marked notes, selecting
                              the second option may take a few seconds.


ΓòÉΓòÉΓòÉ 6.1.5. Print ΓòÉΓòÉΓòÉ

Pull-right selection          Description

Current                       Selects the current note to be printed

All marked                    Selects all marked notes to be printed

                              The printing process does not begin until a
                              printer is selected.


ΓòÉΓòÉΓòÉ 6.1.6. Archive ΓòÉΓòÉΓòÉ

Pull-right selection          Description

Archive                       Archive marked notes of the current folder.

Retrieve                      Retrieve notes in the current folder.

Configure                     Configure the archive option.

                              These options require that your administrator
                              wrote an archive program at your site.


ΓòÉΓòÉΓòÉ 6.1.7. Configure ΓòÉΓòÉΓòÉ

Text Field                    Description

Archive program               Name of the archive program.

Archive options               Options of the archive program.

Retrieve program              Name of the retrieve program.

Retrieve options              Options of the retrieve program.

                              These options require that your administrator
                              wrote an archive program at your site.


ΓòÉΓòÉΓòÉ 6.2. Folders ΓòÉΓòÉΓòÉ

This pull-down contains commands which deal with folder management.

Sort...                       sorts the notes onscreen.

Configure...                  Opens dialog for setting folder options. (See
                              Configure Folder)

Rebuild Folder...             Open dialog for rebuilding folders. (See Rebuild
                              Folder Dialog)

Refresh (F2)                  Refreshes the list of notes in the current
                              folder.

Search folders...             Open the search dialog (See Search Folder Dialog)

Folder Manager... (Alt+F)     Opens dialog for managing folder. (See Folder
                              Manager)

Tile Windows (Alt-T)          Tiles windows within LaMail main window.

Cascade Windows (Alt-C)       Cascades windows within LaMail main window.


ΓòÉΓòÉΓòÉ 6.2.1. Sort ΓòÉΓòÉΓòÉ

This dialog lets you sort the contents of the folder using various fields as
keys. The list box on top lets you select which field you would like to use as
the sort key. The Direction box lets you sort in ascending or descending order.
The text fields (Nickname, Userid, etc.) are sorted alphabetically; the numeric
fields (Size, Date, etc.) are sorted numerically; if Seen is selected then
notes that have been seen are placed after notes not seen if ascending is
selected, or before notes not seen is descending is selected.

Sorting does not begin until a field is selected.  The sort is stable, which
means that if you sort on Userid, then on Node, entries  having the same node
will still be sorted by userid.


ΓòÉΓòÉΓòÉ 6.2.2. Rebuild Folder Dialog ΓòÉΓòÉΓòÉ

This dialog lets you select the folder or notebook you want to rebuild. (e.g.
whenever the Index file corresponding to the folder is corrupted: some notes
are in the mail directory but are not displayed in the corresponding folder).

You can enter a folder name in the entry field, or press the "drop-down" arrow
to the right of the entry field to select from a list of all your existing
folders.

Once the Rebuild process is launched, you can cancel it anytime. It will just
bring back the old folder as it was initially.

If a folder contains a file which is not a valid note, or if any problem occurs
during the Rebuild process, you can check in your Folders directory a file
called Rebuild.LOG. This file contains all the messages displayed during the
Rebuild until it stopped, and allows you to know which note is not valid. Then,
you can remove this note from the proper folder directory and restart the
process.


ΓòÉΓòÉΓòÉ 6.2.3. Folder Manager ΓòÉΓòÉΓòÉ

This dialog lets you manipulate your folders. It has a list showing all your
folders. The View box lets you select whether the list shows the icons
alongside the folder names, or just the text. The entry box at the bottom
contains the selected folder name if you select a folder from the list, or lets
you type in the name of an existing or new folder.

The Create button lets you create a new folder. The folder is a subdirectory in
your Folders directory. (See Changing default directories to set your Folder
directory.) By default, the icon associated with the folder is a picture of a
folder. If you want a custom icon for any folder, place the icon in the Folder
directory with a name of folder_name.ICO.

The Open/Show button will open the selected folder if it does not exist on the
LaMail desktop.  It will restore the folder if it was minimized, and it will
bring the folder to the top of the LaMail desktop. Because the Folder Manager
is useful for finding folders when you have many things on your desktop, it can
be left open while doing other things in LaMail. Select Cancel to make the
dialog go away.

The Delete button deletes the selected folder, provided it is empty. The Folder
Manager will not let you delete a folder containing mail. If you want to delete
a folder containing mail, first open the folder, mark all the mail (select
Notes / Mark All or press Alt+M), then discard the mail by selecting Notes /
Discard / All Marked, or pressing Shift+Alt+F3.

The Rename button lets you rename the selected folder. You will be asked for a
new folder's name.

You can have LaMail automatically open your favorite folders when it starts up
by opening them using the Folder Manager, positioning them where you want, then
selecting Save... from the Options menu.


ΓòÉΓòÉΓòÉ <hidden> Object Handlers ΓòÉΓòÉΓòÉ

This lists all the multi-media mail object handlers that were loaded, as listed
in your media table. The list shows:

BaseType: HandlerName (EncodingField)
where

BaseType            is the base type of the object (Audio, Image, etc.)
HandlerName         is the name of the dynalink library that knows how to
                    handle the object type
EncodingField       is the string used in the Encoding header field in note
                    headers to identify the object type

If you double-click on an entry in the list, a dialog will pop up letting you
set rendering options for objects of that type (if applicable).


ΓòÉΓòÉΓòÉ 6.3. Options ΓòÉΓòÉΓòÉ

This pull-down contains settings for LaMail.

Pull-down selection           Description

Edit names file...            Open the Names File Editing dialog

Set Note Options...           Opens the LaMail Note Options dialog

Set Application options...    Opens dialog for setting LaMail options, and path
                              names used by Lamail. (See Changing default
                              directories)

Configure Printers...         Opens dialog for adding and removing printers
                              from the list.

Save...                       Saves the position of the main LaMail window and
                              all the open folders (including those that are
                              minimized). The next time LaMail is started, all
                              these folders will be opened and positioned as
                              they are now. This lets you keep your most
                              frequently used folders always available on the
                              LaMail desktop.

Sendmail Status...            Displays a panel showing the status of Sendmail


ΓòÉΓòÉΓòÉ 6.3.1. Names File Editing ΓòÉΓòÉΓòÉ

The Nicknames dialog lets you search or update your NAMES file. On the left is
a list containing all the nicknames in the file. Below that is an entry box
showing the currently selected nickname (and where you can type in a new
nickname). To the right are the tags most commonly used for creating notes, and
their values.

The buttons on this dialog are:

Add       Adds a new entry to your NAMES file.

Delete    Deletes this entry from your NAMES file.

Help      Brings up this help panel

Clear     Clears all the fields on the right of the panel

Change    Updates this entry in your NAMES file.

Cancel    Exits the dialog and discard changes.

OK        Exits the dialog and save changes.

Tags...   Brings up the Other Tags dialog, which lets you create or edit tags
          other than those that are displayed on this panel.


ΓòÉΓòÉΓòÉ 6.3.2. Other Tags ΓòÉΓòÉΓòÉ

This dialog lets you view or edit all the tags in a NAMES file entry, rather
than just the subset displayed on the Names File Editing panel. On the left is
a list containing all the tags present for the current nickname. Below that is
an entry box showing the currently selected tag (and where you can type in a
new tag). To the right is the value for the selected tag.

The buttons on this dialog are:

Add       Adds this tag / value combination to the nickname entry.

Delete    Deletes this tag / value combination from the nickname entry

Change    Changes the tag / value combination for this entry to what you have
          entered.

Help      Brings up this help panel

OK        Exits the dialog


ΓòÉΓòÉΓòÉ 6.3.3. Configure Printers ΓòÉΓòÉΓòÉ

This dialog lets you configure which printers LaMail will use. On the left is a
list of configured printers. Below that is an entry field showing the currently
selected printer, and where you can enter a new printer name. At the bottom is
listed your default printer The default printer is the one that is used to
print the current note if you press Alt+P.

The buttons on this dialog are:

OK        Accept all changes and exit the dialog

Cancel    Throw away all changes and exit the dialog

Help      Brings up this help panel

Add       Add a new printer to the list

Remove    Remove the selected printer from the list

Set Default Makes the selected printer the default printer


ΓòÉΓòÉΓòÉ 6.4. Transfer ΓòÉΓòÉΓòÉ

This pull-down contains commands which deal with Export/Import .

Pull-down selection           Description

Prepare remote volume...      Prepares a remote volume (typically a floppy) for
                              export

Export                        Export notes to the remote volume

Import...                     Import notes from the remote volume

Configure...                  Opens dialog for setting LaMail Transfer options
                              .


ΓòÉΓòÉΓòÉ 6.4.1. Export/Import ΓòÉΓòÉΓòÉ

With the Export/Import functions, LaMail lets you export mail to a floppy, then
by starting LaMail on your home machine in remote mode, you can work on your
mail without being connected to the network. You can later import the mail back
and all the changes will be commited to your primary workstation.

Before exporting mail, you need to prepare the remote volume (typically a
floppy). This will copy onto the floppy some information relative to the
folders, their configuration, your names file, etc. The floppy needs to be
reprepared after every import.

On the stand-alone machine, you need to start lamail with the /remote option at
the command prompt. LaMail will work as usual except it will work with the
floppy. Also, notes that are sent will actually be stored on the floppy and
sent only when imported to the primary workstation.

When started in remote mode, LaMail assume that the remote volume path is the
one defined in the Transfer options dialog. You can also define the remote
volume from the prompt by specifying the path after the /remote option. (e.g.
start lamail /remote a:)


ΓòÉΓòÉΓòÉ 6.4.2. Export ΓòÉΓòÉΓòÉ

Pull-right selection          Description

Current Note                  Exports the current note

All Marked                    Exports all marked notes

All                           Exports all notes in the current folder


ΓòÉΓòÉΓòÉ 6.4.3. Transfer options ΓòÉΓòÉΓòÉ

This dialog lets you configure the export/import function.

Enter path where to export mail: Path where mail should be exported. Typically,
          this will be the path to the a: drive. It can be any valid OS/2
          directory.

The boxes on this dialog are:

Import Names file If this box is checked, the Names file will be imported if it
          was updated on the remote workstation. The default is that the Names
          file should be imported back.

Cleanup export directory when preparing it If this box is checked, LaMail
          Erases the export directory during the prepare floppy operation. This
          is the default and prefered option.

Remind to take floppy after export If this box is checked, LaMail will display
          a message at the end of every export operation in order to remind the
          user to bring his floppy with him when he leaves. The default option
          is that LaMail displays the message.

Propose to re-prepare volume after import If this box is checked, LaMail will
          propose to re-prepare the remote volume just after the import
          operation. The default is that LaMail proposes this option
          automatically.


ΓòÉΓòÉΓòÉ 6.5. Help ΓòÉΓòÉΓòÉ

Pull-down selection           Description

LaMail Help (F1)              Start LaMail Help Manager session


ΓòÉΓòÉΓòÉ 6.6. Exit ΓòÉΓòÉΓòÉ

Pull-down selection           Description

Exit LaMail                   Exits LaMail.

Resume LaMail                 Resumes LaMail


ΓòÉΓòÉΓòÉ 7. Configure Folder ΓòÉΓòÉΓòÉ

This dialog box allows you to change the various properties of each folder on a
per-folder window basis.  When you open a folder (including the InBasket Folder
which is opened during LaMail initialization), the corresponding
folder_name.CFG file is read. If the .CFG file does not exist, the defaults are
taken from the LAMAIL.CF configuration file.

For example, while viewing your OLDMAIL folder, if you change the USERID field
color from Black to Red and save these changes, a file named OLDMAIL.CFG will
be created.  This file will be placed in the directory defined as the
configuration directory (See Changing default directories).

The Configure Folder dialog will let you customize:

o the colors used (see Set Colors)
o the ordering of each column in the folder (see Set Position)
o the font used for the mail list
o the order in which the folder is sorted (see Set Sort Order)
o whether or not a horizontal scroll bar is present in the list

The buttons on the dialog are:

Set dflt  Makes these settings the default for any folder not having custom
          settings.
Get dflt  Retrieves the default settings.
Help      Brings up this help panel
OK        Uses the dialog settings for the current folder. Does not modify any
          saved settings.
Save      Saves the dialog settings for the current folder.
Cancel    Reverts to the settings that were being used before the Configure
          Folder dialog was brought up.


ΓòÉΓòÉΓòÉ 7.1. Set Colors ΓòÉΓòÉΓòÉ

This lets you set the colors of the list column headings (referred to as
fields) and the color of the main window areas. When you select a field or area
in the left listbox, the current color for that field is selected in the right
listbox.

In addition to the standard colors (red, blue, green, etc), you can select
Hidden, which suppresses the display of that field.


ΓòÉΓòÉΓòÉ 7.2. Set Position ΓòÉΓòÉΓòÉ

This lets you set the order in which the column headings (referred to as
fields) appear in the list. When you select a field in the left listbox, the
current position for that field is displayed in the Position entry field. The
leftmost field is number 1. Fields are displayed from left to right, skipping
any that have a color of Hidden.

To change the field order, select the field in the left listbox, then type the
new position for that field in the Position entry field.

Suppose you have the following field order defined:

    1    2    3     4
  Seen Date Time Userid ...

If you wanted the "Time" field to appear before the "Date" field, first select
"Time" in the Field/Area list, then enter "2" in the Position entry field. All
fields to the right will be renumbered appropriately.

If certain non-hidden fields are not visible, it is because they are shown
outside of the folder window.  Either re-size the window or use the horizontal
scroll bar to see them.


ΓòÉΓòÉΓòÉ 7.3. Set Sort Order ΓòÉΓòÉΓòÉ

This lets you set the order in which the list is sorted when a folder is opened
or refreshed. When you select a field in the left listbox, the current sort
order for that field is displayed in the Sort order entry field. If the field
is not being sorted on, the Sort order field is blank. If the field has a sort
order, then the ascending/descending buttons in the Sort Direction box tell you
in which direction the list is sorted. The list is sorted in the specified
direction for each field that has a sort order specified, starting with the
field with sort order 0.

The sort is stable, which means that if you sort on Userid, then on Node,
entries having the same node will still be sorted by userid. The last sort
performed is the main order in which the folder will be presented. For example,
if you want your InBasket to be presented with all the unread notes first,
followed by all the ones you've seen, and within each group, you wanted to see
the newest notes first, you would set your sort fields as follows:

Time    0     Descending
Date    1     Descending
Seen    2     Descending

This will first sort on Time, then on Date, so the newer files are listed
before the older ones; finally, it will sort on Seen, so that the files marked
as having been seen will appear after those that haven't been seen. Both groups
will still be sorted from newest to oldest within the group.


ΓòÉΓòÉΓòÉ 8. Accelerator keys defined by LaMail ΓòÉΓòÉΓòÉ

Enter                         When in a folder, views the current note

Tab                           Activates the next folder window on LaMail
                              desktop

Ctrl+Tab                      Switches focus between folder window and open
                              folder list

Alt or F10                    Activates Action bar of LaMail application window

Alt+Space                     Activates System menu of main window

Alt+F1                        Views the current note

Alt+F2                        Receives the note into the default folder

Alt+F3                        Discards the current note

Shift+Alt+F1                  Views all marked notes

Shift+Alt+F2                  Receives all marked notes to the default folder

Shift+Alt+F3                  Discards all marked notes

Alt+M                         Marks all notes in the current folder

Alt+F                         Brings up the Folder Manager

Alt+N                         Starts a new note

Alt+E                         Edits a new or existing file

Alt+W                         Displays a list of all LaMail edit windows

Alt+U                         Unmarks all mail files in the current folder

Alt+I                         Marks unmarked files and unmarks marked files

Alt+T                         Tiles the folder windows

Alt+C                         Cascades the folder windows

Alt+A                         Arranges LaMail and Mail View Windows for the
                              "Edit all in one" or "fast browse" function

Alt+Z                         Brings up the Object Handlers dialog

F2                            Updates the current folder list with the contents
                              in the folder directory (This happens
                              automatically for the Sendmail InBasket.)


ΓòÉΓòÉΓòÉ 9. LaMail mouse actions ΓòÉΓòÉΓòÉ

The following mouse actions have been defined in LaMail:

Mouse Action                  Description

Left button single click      Moves the box cursor to the pointer

Left button single click & drag Moves the box cursor

Left button double click      Views the current note

Right button single click     Toggles mark

Right button single click & drag Toggles the mark of the line originally
                              containing the cursor, then marks or unmarks all
                              lines over which the cursor is dragged to the
                              same as the original line.


ΓòÉΓòÉΓòÉ 10. Viewing and Writing Notes ΓòÉΓòÉΓòÉ

LaMail allows a user to view and create notes.  When a note is viewed, LaMail
opens a window containing the note.  From this window, the note may be viewed,
replied to, forwarded, and new mail may be created.  The choices are:

Mail      Mail-related commands.
File      actions affecting the identity of the file being edited.
Edit      actions relating to marks or the clipboard.
Search    search for or change text, or repeat a previous Find or Change
          command.
Options   Miscellaneous items including configuration and spell-checking.
Command   bring up the command dialog, or halt a command
Help      ask for help.


ΓòÉΓòÉΓòÉ 10.1. Mail pull-down ΓòÉΓòÉΓòÉ

The Mail pull-down allows you to specify what action is to be taken on the
current mail item.  The choices and a brief description of the commands can be
found in the following sections:

Reply     for sending a reply to a note.
Move/Receive for receiving mail to a folder.
Discard (Alt+F3) for discarding mail from the inbasket or a folder.
Print     for printing a copy of a note.
Create new note for beginning a new note from scratch.
Send (F5) to send the new note to its addressees.
Add Addressees to add addressees to the note currently being edited.


ΓòÉΓòÉΓòÉ 10.1.1. Reply ΓòÉΓòÉΓòÉ

Pull-right selection          Description

Reply to note (Alt-F2)        Replies to the note being viewed

Use Reply Dialog              Brings up the reply dialog.

Forward Note                  creates a new note, appending a copy of the
                              current note.

Forward Note to Sender        Replies to the note being viewed, including a
                              copy of the original note.


ΓòÉΓòÉΓòÉ 10.1.2. Move/Receive ΓòÉΓòÉΓòÉ

Pull-right selection          Description

Receive to default host notebook Moves note to the default notebook.  See Move
                              in the Command Menus section for a description of
                              how the default notebook is derived.

Prompt for notebook           Prompts you for the notebook to receive the note
                              into

Receive to default workstation folder Moves note to the default workstation
                              folder.

Prompt for folder             Prompts you for the workstation folder to receive
                              the note into


ΓòÉΓòÉΓòÉ 10.1.3. Print ΓòÉΓòÉΓòÉ

Pull-right selection          Description

LPTx:                         Prints the current note on the selected printer


ΓòÉΓòÉΓòÉ 10.2. Set Note Options ΓòÉΓòÉΓòÉ

When this item is selected a panel is presented that allows a user to change
note creation defaults.  The fields on this panel are as follows:

Field prompt             Description

Your Userid              Your personal userid

Your Node                Your host name

Default Folder           The folder to which you want mail to be received if
                         not otherwise specified. The default value is "ALL".
                         An asterisk (*) can be entered if it is desired that
                         the default folder for mail from any user without a
                         names file entry be that person's userid.

Time Zone                The time zone from which you are operating

Address Format           The long address format tells LaMail to look up the
                         recipient in the nicknames file.  If found, the value
                         for the :NAME. tag is used in constructing the reply
                         header.  If not found, or short address format is
                         selected, the userid and node only is used.

Add Subject line         A subject line is added when a note header is created

Use :address. Contents   Add the address of the sender if found in the
                         nicknames file.

Use :phone. Contents     Add the phone of the sender if found in the nicknames
                         file. Also include the phone number of all addressees
                         found in the nicknames file if the longformat is being
                         used.

Use :folder. Contents or :notebook. Contents Specifies whether the folder or
                         the notebook tag in the nicknames file should be used
                         for the target folder when receiving mail from the
                         Sendmail InBasket. (The latter is convenient for users
                         who wish to use the same nicknames file for LaMail as
                         they do on their VM host.)

Names File               Location of your nicknames file.  Specify drive, path,
                         and filename

Reply To: field          A Reply-to line is added when a note header is created

Signature File           A signature file is a file containing an arbitrary
                         number of lines of text that are suffixed to the reply
                         note (typically containing your name).  Make sure you
                         specify the drive, path, and filename of the signature
                         file.

                         A sample signature file might look like this:

                                                  Larry Smith
                                                  IBM Corporation
                                                  (Another Happy LaMail user.)

Reply in a New Window    A note can be answered from the window it is being
                         viewed from, or a new window can be created for the
                         reply note. It's faster to not open a new window, but
                         some users may prefer to have both the original note
                         and the reply visible on the screen at the same time.


ΓòÉΓòÉΓòÉ 10.3. Create Note Dialog ΓòÉΓòÉΓòÉ

The Create Note Dialog allows you to create a note specifying the following, in
the corresponding fields:

o To:

   A list of addresses can be specified in this field. This list of addresses
  can contain one or more of the following possible addressee formats:

    user at host
    user@host
    nickname

  LaMail uses the addressee fields to determine the destination of the note.
  LaMail does not verify the user or the node.  If Sendmail cannot send the
  mail, it is returned to the InBasket.
o cc: (Carbon Copy) This is an optional field.  A list of addressees can be
  specified in this field, in the same format described above. A carbon copy of
  the note will be sent to each addressee.
o bcc: (Blind Carbon Copy) This is an optional field. A list of addressees can
  be specified in this field, in the format described above. A carbon copy of
  the note will be sent to each addressee, however, the note will not contain a
  header line showing that a note was sent to any of the addressees specified.
o Folder: An optional folder name can be specified.  A copy of the note that is
  about to be created will be placed in this folder when the note is sent.

In addition, the dialog contains a listbox containing all the entries from your
NAMES file. For each entry, it shows the nickname and the person's name.
Double-clicking on an entry in the list, while the text cursor is in the To:,
cc:, or bcc: fields adds that nickname to the list.


ΓòÉΓòÉΓòÉ 10.4. Add Addressees Dialog ΓòÉΓòÉΓòÉ

The Add Addressees Dialog allows you to add additional recipients to a note.
Entries in the To: field are added to the To: field of the current note.

Entries in the cc: field are added to the cc: field of the current note. If a
cc: field does not exist, one will be created.

Entries in the bcc: field are added to the bcc: field of the current note. If a
cc: field does not exist, one will be created.

If a folder name is entered in the Folder: field, this will replace the current
folder being used for the note (if any). If the field is left empty, whatever
was previously going to be used remains unchanged.

The dialog contains a listbox containing all the entries from your NAMES file.
For each entry, it shows the nickname and the person's name. Double-clicking on
an entry in the list, while the text cursor is in the To:, cc:, or bcc: fields
adds that nickname to the list.


ΓòÉΓòÉΓòÉ 10.5. Open Folder Dialog ΓòÉΓòÉΓòÉ

The Open Folder Dialog allows you to open a mail folder list on the LaMail
application desktop.

A list box containing all mail folders is presented.  Selecting a folder,
either with your pointing device or using the keyboard, will cause the
highlighted folder to be opened.

The folder list box can be viewed in text form or in icon form. The "View" menu
on this dialog will allow you to toggle between icon or text representations of
your mail folders.

Note: the current view is remembered between invocations of this dialog.


ΓòÉΓòÉΓòÉ 10.6. Delete Folder Dialog ΓòÉΓòÉΓòÉ

The Delete Folder Dialog allows you to delete a mail folder.

A list box containing all mail folders is presented.  Selecting a folder,
either with your pointing device or using the keyboard, will cause the
highlighted folder to be deleted.

The folder will only be deleted if all notes in that folder have been
discarded.

The folder list box can be viewed in text form or in icon form. The "View" menu
on this dialog will allow you to toggle between icon or text representations of
your mail folders.

Note: the current view is remembered between invocations of this dialog.


ΓòÉΓòÉΓòÉ 11. Mail Related Commands ΓòÉΓòÉΓòÉ

These mail related commands can be issued from the edit window's command line.

Command                       Description

DISCARD                       Throw away the current mail file

FOLDER [folder_name]          Specify the folder to be used for the note
                              currently being edited. If a folder name is
                              specified, it will be used as the folder when the
                              note is sent. If no name is given, a dialog will
                              be presented showing the current folder, and the
                              user can change this to any desired folder, or
                              select No Folder.

FORWARD addressee             Forward the current note to one or more people

NOTE addressee                Start a note

RECEIVE [folder_name]         Receives the current mail file into the given or
                              default folder

REPLY                         Start a note to the sender of the current note

SEND                          Send the current note. If a folder has been
                              specified, a copy of the note is saved in that
                              folder. The note is also saved in the OUT folder;
                              this copy is reloaded if there is a Sendmail
                              error, or deleted when the note has been sent.

Note:  The addressee  parameter to the above functions can be one or more of
the following:

o user-id@host

o nickname


ΓòÉΓòÉΓòÉ 12. Nicknames File ΓòÉΓòÉΓòÉ

A nicknames file is a file that contains one or more groups information about a
particular userid.  The information is classified by the associated tags that
are prefixed to each item.  By creating nicknames, you only need to specify a
nickname instead of the userid and node associated with that nickname.
Additionally, the name and phone number may be added, as well as a list of
destinations.

A sample nicknames files might look as follows:

:NICK.ME       :USERID.YourID   :NODE.YourNode
               :NAME.Your name in lights!
               :ADDR.123 Main Street;Yorktown Heights;U.S.A.

:NICK.LARRY    :USERID.LARRY    :NODE.LaMail.NetOne.NetTwo
               :NAME.Larry Smith
               :FOLDER.LaMail

:NICK.GROUP    :list.LARRY JERRY@YORKTOWN ME
               :NAME.Our Group
               :FOLDER.GROUP

As an example, if you wanted to write a note to Larry Smith, you would have to
enter "[e-mail]" when asked.  If you frequently send notes to
Larry, then this becomes cumbersome.  However, since Larry has a nickname
assigned to him, all you would have to do is type "LARRY" and LaMail will find
his entry in your nicknames file.

The valid tags, and an explanation of each, follows:

Tag name                      Description

:NICK.                        The nickname to be assigned to this userid and
                              node

:USERID.                      The userid of this person

:NODE.                        The nodeid of this person

:PHONE.                       The phone number of this person

:FOLDER.                      The folder that all mail received from this
                              person gets placed into

:ADDR.                        The mailing address of this person. Only used for
                              the sender of the note, and only if the Use
                              :address. Contents field is checked on the LaMail
                              Note Options panel.

:LIST.                        A list of previously defined nicknames and/or
                              full destination addresses. Helpful when creating
                              distribution lists.

:NICK.  and either :USERID.  and :NODE.  or :LIST. tags are required.  Any tags
not mentioned above may be present for other applications, but will be ignored
by LaMail.

Two things should be noted:  first, the tag names do not have to be in
uppercase and, second, a nickname begins  with the tag :NICK..

The ME nickname has a special meaning and is used during Replies in order to
remove your userid from the list of adressees. You can have several ME entries
if you have several addresses.

The default LaMail names file is called NICKNAME.NAM.  It should be placed in
the \TCPIP\LAMAIL directory.  This can be changed on the LaMail Note Options
panel.

To add a nickname to the file, you can use any text editor to add the
appropriate tags and their values, or you can select Names File Editor from the
LaMail Options pull-down.


ΓòÉΓòÉΓòÉ 13. General LaMail Note Editor Help. ΓòÉΓòÉΓòÉ

LaMail's Note Editor  Help provides help for the following:

o Help for Editor Tasks which consist of:

   - Help for Editor Keys
   - Help for Marking Text
   - Help for Recording Keystrokes

o Help for Editor Dialog Boxes

o Help for Editor Commands

o Help for direct file manipulation using the File icon control.


ΓòÉΓòÉΓòÉ 13.1. (Go To Line) ΓòÉΓòÉΓòÉ

Syntax:  [+|-]nnnn

Use this command to move the cursor to another line.  It can be used three
ways:

nnnn
          Moves to line number nnnn.
+nnnn
          Moves forward (down) nnnn number of lines.
-nnnn
          Moves backward (up) nnnn number of lines.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.2. ACTIVATEACCEL (Activate an Accelerator Table) ΓòÉΓòÉΓòÉ

Syntax:  ACTIVATEACCEL [table_name]

Use ACTIVATEACCEL in a Rexx macro to activate the named accelerator table.  If
no name is given, the current accelerator table (which could have been updated
with the BUILDACCEL command) is rebuilt.

Related Information:

o BUILDACCEL


ΓòÉΓòÉΓòÉ 13.3. ADD (Add Block) ΓòÉΓòÉΓòÉ

Syntax:  ADD

Use ADD to add the numeric expressions in the current mark, and display the
result on the next line after the mark.  The mark must be either a block mark
or a line mark.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands
o MULT
o MATHx


ΓòÉΓòÉΓòÉ 13.4. ALL (Find All Text) ΓòÉΓòÉΓòÉ

Syntax:  ALL /search_string[/[c]]

Use ALL to create a temporary file showing all occurrences of search_string in
the current file.

The c option ignores case in the search_string. For example, "Search",
"search", and "SEARCH" are treated the same.

The delimiter used to separate search_string and the options is the first
non-blank character following "ALL."

Once the command has completed processing, use Ctrl+Q to switch between the
result file and the search file.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.5. APPEND, APP (Append to File) ΓòÉΓòÉΓòÉ

Syntax:  APPEND or APP [filespec]

Use APPEND to add the marked text to the file filespec.  If no text is marked,
the entire current file is taken as the source.  The equals sign, "=" can be
used as a shorthand for various parts of the file specifier.

For convenience, filespec can be omitted if you wish to repeat an APPEND to the
same file.  APPEND commands without a filespec reuse the last-specified name.

You can print a marked block of text by issuing APPEND LPTn. (But the PRINT
command prints a block if one is marked.)

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands
o PRINT
o Marking text


ΓòÉΓòÉΓòÉ 13.6. ASC (Get ASCII Value) ΓòÉΓòÉΓòÉ

Syntax:  ASC [char]

Use ASC to display the ASCII value of the specified character.  If no character
is specified, the character at the cursor is used.

Note:  The ASC command is the opposite of the CHR command.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.7. AUTOSAVE (Query or Set Autosave Value) ΓòÉΓòÉΓòÉ

Syntax:  AUTOSAVE [#### | ON | OFF | ? | DIR]

Use AUTOSAVE to display or set the autosave values. The parameters are:

[none]
          Displays the current values on the message line, and places an
          AUTOSAVE command in the command window where you can change it.
####
          Sets the current autosave count to the specified number.
ON
          Sets the current autosave count to the default value.
OFF
          Sets the current autosave count to 0, turning off autosaves.
?
          Displays the current values in a window, with a button you can select
          to list all files in the autosave directory.
DIR
          Lists all files in the autosave directory.

The autosave values displayed are the autosave count (after this many changes
are made to the file, an automatic save is done to a temporary file) and the
autosave file name (the file which is saved whenever the autosave count is
reached).  The default autosave count is set through the Configure window.  The
autosave path is also set in the Configure window; the autosave file name is
constructed from the autosave path, the current file name, and a unique 3-digit
extension.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.8. BOT, BOTTOM (Go To Bottom) ΓòÉΓòÉΓòÉ

Syntax:  BOTTOM or  BOT

Use BOTTOM to move the cursor position to the last line of the file.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.9. BOX (Box Mark) ΓòÉΓòÉΓòÉ

Syntax:  BOX 1|2|3|4|5|6|C|P|A|E|B|/character

Use BOX to draw a box around the current block mark.  The box type depends on
the option specified:

1
          Single line.
2
          Double line.
3
          Dotted line.
4
          Thick line.
5
          Double line horizontally; single line vertically.
6
          Single line horizontally; double line vertically.
C
          Comment box using C language syntax.
P
          Comment box using Pascal language syntax.
A
          Comment box using Assembler language syntax.
E
          Erases the box surrounding the block mark.
B
          Box of blanks.
/character
          Box of specified character.

Note:  If a proportional font is used, the lines will not appear to line up
       vertically even though they are in the correct columns.  Use a
       non-proportional font (for example, System Monospaced or Courier) if you
       want the characters to line up on the screen.

Note:  The single-to-double line intersections used in box styles 5 and 6 will
       display as national characters in some code pages.  Either change to a
       different code page, or use a different box style.

Note:  Graphic characters cannot be sent in mail messages.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.10. BROWSE (Query or Set Browse Mode) ΓòÉΓòÉΓòÉ

Syntax:  BROWSE [ON | OFF | ?]

Use BROWSE to determine if the file can be updated. The parameters are:

ON
          File can be read, but not updated.
OFF
          File can be read and updated.
?
          Browse mode (ON or OFF) is displayed.

Note:  Browse mode applies to the entire edit ring, not to a specific file.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.11. BUILDACCEL (Build Accelerator Table Entry) ΓòÉΓòÉΓòÉ

Syntax:  BUILDACCEL table flags key index command

Use BUILDACCEL to add an accelerator table entry to an accelerator. table is
the name of the table to be updated; use '*' to indicate the currently active
accelerator table.  flags is a combination of flags corresponding to the AF_
constants in PMWIN.H in the OS/2 Toolkit, keys is an ASCII key value if flags =
AF_CHAR; a VK_ constant from PMWIN.H if flags = AF_VIRTUALKEY, etc.  (See the
EPM Technical Reference for further details.)  index is a unique number (unique
in the active menu as well as the active accelerator table), and command is the
command to be executed when the key is pressed.

/* Rexx example of accelerator key definition */
   AF_CHAR        =   1   /* key style constants */
   AF_VIRTUALKEY  =   2
   AF_SCANCODE    =   4
   AF_SHIFT       =   8
   AF_CONTROL     =  16
   AF_ALT         =  32
   AF_LONEKEY     =  64

   VK_F1        = 32
   VK_ALT       = 11

'buildaccel *' (AF_CHAR + AF_CONTROL)      122 9300 'sayerror Ctrl+z pressed'
                                  /* ASCII 122 = 'z' */
'buildaccel *' (AF_CHAR + AF_CONTROL)       90 9301 'sayerror Ctrl+Z pressed'
                                  /* ASCII  90 = 'Z' */
'buildaccel *' (AF_VIRTUALKEY + AF_ALT)  VK_F1 9302 'qtime'
                                /* Alt+F1 tells the time */
'buildaccel *  (AF_VIRTUALKEY + AF_LONEKEY)  VK_ALT 9303 'sayerror F10 = action bar'
                                /* Block Alt key from going to the action bar. */
'activateaccel'  /* No argument => use current table name. */

Related Information:

o ACTIVATEACCEL


ΓòÉΓòÉΓòÉ 13.12. BUILDMENUITEM (Add Menu Item to Pulldown) ΓòÉΓòÉΓòÉ

Syntax:  BUILDMENUITEM menuname submenuid menuitemid submenutext attrib
helppanel e_command

Use BUILDMENUITEM in a Rexx macro to add menu items to an action bar pulldown.
Buildmenuitem adds a menu item to the pulldown with ID submenuid in the menu
named menuname. The text displayed on the pulldown will be submenutext (which
can not contain spaces). The attribute will be attrib (see the menu calls in
the OS/2 Technical Reference for the various attributes, or just use 0), the
help panel resid that will be displayed if the user presses F1 while the menu
item is selected is helppanel (0 if no help for that menu item), and e_command
is the command that will be executed if that menu item is selected. All the
menuitemid's must be unique.

/* Rexx sample .erx file - adds "RexxInterface" to the action bar, */
/* with two menu entries under it.                               */
'buildsubmenu default 1990 RexxInterface  0 0'
'buildmenuitem default 1990 1991 AddCommentFields      0 0 rx comment'
'buildmenuitem default 1990 1992 ShowRexxDateFormats   0 0 rx rxdates'
'showmenu default'

The submenuids for the standard menus are:

File        2
Edit        8
Search      3
Options     4
Command     1
Help        6

Related Information:

o BUILDSUBMENU
o DELETEMENU
o SHOWMENU


ΓòÉΓòÉΓòÉ 13.13. BUILDSUBMENU (Build an Action Bar Pulldown) ΓòÉΓòÉΓòÉ

Syntax:  BUILDSUBMENU menuname submenuid submenutext attrib helppanel e_command

Use BUILDSUBMENU in a Rexx macro to create a new action bar entry. Buildsubmenu
adds a pulldown to the action bar menu named menuname, as submenu number
submenuid.  The text displayed on the action bar will be submenutext (which can
not contain spaces), the attribute will be attrib (see the menu calls in the
OS/2 Technical Reference for the various attributes, or just use 0), the help
panel resid that will be displayed if the user presses F1 while the menu item
is selected is helppanel (0 if no help for that menu item), and e_command is
the command that will be executed if that menu item is selected.  It should be
blank (omitted) if you want to define a pull-down; if a command is defined in
the Buildsubmenu opcode then it will act immediately.  If no command is
defined, then the pull-down menu presented will be all the menu items added via
Buildmenuitem calls that specified the same submenuid.

Related Information:

o BUILDMENUITEM
o DELETEMENU
o SHOWMENU


ΓòÉΓòÉΓòÉ 13.14. CD (Change Directory) ΓòÉΓòÉΓòÉ

Syntax:  CD [ [drive:]path ]

Use CD to change the current directory to the drive and path specified.  If
neither drive nor path are specified, the current directory is displayed.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.15. CENTER (Center Mark) ΓòÉΓòÉΓòÉ

Syntax:  CENTER

Use CENTER to center the text within the current mark.  If the current mark is
a line mark, the text is centered using the current margins.  If the current
mark is a block mark, the text is centered using the block boundaries for the
margins.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.16. CHANGE, C (Change Text) ΓòÉΓòÉΓòÉ

Syntax: CHANGE or  C /search_string /replace_string/options

Use CHANGE to find search_string and replace it with replace_string, depending
on the options specified:

-
          Searches from the current cursor position backward.
+
          Searches from the current cursor position forward.
*
          Replaces all occurrences of search_string with replace_string.
M
          Searches within the marked area only.
A
          Searches within the entire file.
C
          Ignores case while searching for search_string.
E
          Respects case while searching for search_string.
R
          Search reversed, right to left, within each line.
F
          Search forward, left to right, within each line.

The default options are + A E F.

The delimiter used to separate search_string, replace_string, and the options
is the first non-blank character following C.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands
o Search dialog


ΓòÉΓòÉΓòÉ 13.17. CHR (Get Character for ASCII Value) ΓòÉΓòÉΓòÉ

Syntax:  CHR ASCII_character_code

Use CHR to display the character associated with the ASCII_character_code
specified.

Note:  The CHR command is the opposite of the ASC command.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.18. CLOSE (Close the Edit Window) ΓòÉΓòÉΓòÉ

Syntax:  CLOSE

Use CLOSE to quit all the files in the current edit ring and close the edit
window.  Before quitting any modified files in the ring, a window appears which
enables you to select Save to save the file, Discard to discard the changes, or
Cancel to cancel the close.  If you select Cancel for any of the modified
files, no files are removed from the ring.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.19. COPY2CLIP (Copy to Clipboard) ΓòÉΓòÉΓòÉ

Syntax:  COPY2CLIP

Use COPY2CLIP to copy the text within the current mark to the clipboard for
transfer to other files being edited, or to other programs.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands
o CUT
o PASTE


ΓòÉΓòÉΓòÉ 13.20. CUT (Cut Text) ΓòÉΓòÉΓòÉ

Syntax:  CUT

Use CUT to copy the text within the current mark to the clipboard for transfer
to other files being edited, or to other programs.  The marked text is deleted
from the file.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands
o Marking text
o COPY2CLIP
o PASTE


ΓòÉΓòÉΓòÉ 13.21. DELETEMENU (Delete a Menu Item) ΓòÉΓòÉΓòÉ

Syntax:  DELETEMENU menuname submenuid menuitemid itemonly

Use DELETEMENU to delete an action bar or pulldown menu item. menuname is the
name of the menu.  submenuid is the pulldown submenu that is to be deleted.
(To delete all submenus set this parameter to 0.) menuitemid is the item to
start deleting off a particular submenu (To delete all menu items under a
submenu, set this parameter to 0.) itemonly is true if it is desired to delete
only the items under a sub-menu but not the sub-menu itself.

Related Information:

o BUILDMENUITEM
o BUILDSUBMENU
o SHOWMENU


ΓòÉΓòÉΓòÉ 13.22. DIR (Directory List) ΓòÉΓòÉΓòÉ

Syntax:  DIR [ path ]

Use DIR to open a temporary file containing the directory listing for the path
or the current directory, if no path is specified.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.23. DISPLAY (Change Message Display Actions) ΓòÉΓòÉΓòÉ

Syntax:  DISPLAY number

Use DISPLAY in a Rexx macro to control message display and screen updating.  A
negative number turns the display control off, and a positive number turns it
back on.  You can turn on or off multiple flags in one DISPLAY call by adding
them together, provided they are all positive or negative. -1 turns off screen
update; 1 turns it back on. -2 turns off the display of messages; 2 turns it
back on. -4 forces messages to be displayed in the message box; 4 reverts to
displaying them on the message line; -8 prevents messages from being saved in
the message box list; 8 lets them be saved.


ΓòÉΓòÉΓòÉ 13.24. DOLINES (Executes Lines) ΓòÉΓòÉΓòÉ

Syntax:  DOLINES

Use DOLINES to process the current line or all marked lines as though they were
typed in the Command window.  The line or lines must be editor or OS/2*
commands.  If a line mark exists, you are asked if you want to process all
marked lines.  You can select Yes, No (to only process the current line), or
Cancel.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.25. DPATH (Show DPATH Setting) ΓòÉΓòÉΓòÉ

Syntax:  DPATH

Use DPATH to open a temporary file containing the DPATH environment setting.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.26. DRAW (Draw Text Graphics) ΓòÉΓòÉΓòÉ

Syntax:  DRAW 1|2|3|4|5|6|B|/character

Use DRAW to draw lines within your document, using the built-in graphics
characters.  The type of line depends on the option specified:

1
          Single line.
2
          Double line.
3
          Dotted line.
4
          Thick line.
5
          Double line horizontally; single line vertically.
6
          Single line horizontally; double line vertically.
B
          Blank line, for erasing other lines.
/character
          Line of specified character.

Note:  If a proportional font is used, the lines will not appear to line up
       vertically even though they are in the correct columns.  Use a
       non-proportional font (for example, System Monospaced or Courier) if you
       want the characters to line up on the screen.

Note:  The single-to-double line intersections used in drawing styles 5 and 6
       will display as national characters in some code pages.  Either change
       to a different code page, or use a different drawing style.

Note:  Graphic characters cannot be sent in mail messages.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.27. ECHO (Echo Commands) ΓòÉΓòÉΓòÉ

Syntax:  ECHO [ON | OFF]

Use ECHO to switch the echo mode on or off; anything else tells you the current
value.  When echo mode is on, every command is displayed in the message field
before being processed.  The parameters are:

[none]
          Displays current value.
ON
          Every command is displayed in the message field before being
          processed.
OFF
          No commands are displayed.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.28. EDIT, E (Edit File) ΓòÉΓòÉΓòÉ

Syntax:  EDIT or E [ [options] [=]file1 ][, [options] [=]file2 ]...

Use EDIT to load the specified files into the current ring, using the options
specified for each file:

/C
          Create a new file with the given name.
/D
          Search for the file on disk.
/L
          use the OS/2 and DOS convention that a new line is signified by a
          carriage return followed by a line feed.  Carriage returns or line
          feeds standing by themself are kept as text.
/N
          Search for the file in the current ring.
/T
          Do not expand tabs when the file is loaded.  The default is to expand
          all tabs to an appropriate number of spaces.
/U
          use the Unix convention that a line feed alone is sufficient to start
          a new line when loading a file.  Carriage returns are discarded.
          (This is the default.)

The equals sign, "=" can be used as a shorthand for various parts of the file
specifier.

Commands (inside paired single quotes) can be intermixed with the file names.
The files are loaded and the commands executed in the order in which they
appear on the command line. For example:

E new.c 'get skeleton.c' 'bot'

File names containing spaces or "=" must be enclosed inside paired double
quotes.  Commands containing single quotes can have the quotes doubled up.  For
example:

e "c:\This name contains spaces"  'L /It''s'

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.29. EPATH, EP (Edit a File in a PATH Setting) ΓòÉΓòÉΓòÉ

Syntax:  EPATH or EP filespec [pathname]

Use EPATH to search an environment setting for the specified file and load it.
The path name defaults to EPMPATH, except if the file specifier extension is
CMD; then the path name defaults to PATH. Examples:

ep mycnf.e
          Searches the EPMPATH setting for MYCNF.E.
ep test.cmd
          Searches the PATH setting for TEST.CMD.
ep main.c include
          Searches the INCLUDE setting for MAIN.C.

The search order is:

 1. The current directory
 2. Each directory listed in the path setting

If the file is found in the search path, it is loaded from that subdirectory.
If not, an empty file with that name will be loaded.  The path will default to
the current directory.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.30. ESCAPEKEY (Toggle Escape Key Action) ΓòÉΓòÉΓòÉ

Syntax:  ESCAPEKEY [ON | OFF]

Use ESCAPEKEY to switch the escape key mode on or off; anything else tells you
the current value.  When escape key mode is on, the escape key can be used to
bring up the command line dialog (just like Ctrl+I).  This is for compatability
with previous versions of EPM.  The default is escape key mode off.

You must issue this command from the Command window.

To save the current escape key mode setting as your permanent default:

 1. Select Options.
 2. Select Save options.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.31. EXPAND (Syntax Expansion) ΓòÉΓòÉΓòÉ

Syntax:  EXPAND [ON | OFF]

Use EXPAND to set syntax expansion ON or OFF.  If no parameters are given, the
current value is displayed.

Syntax expansion occurs when Space or Enter is pressed while a file with a
supported language-specific extension is active (for example C, PAS, or CMD).
When automatic expansion is off, you can force expansion to occur by pressing
Ctrl+X.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.32. FILE (Save and Quit) ΓòÉΓòÉΓòÉ

Syntax:  FILE [ [=]filename ] [options]

Use FILE to store the file (using the file name specified, or the current file
name) and quit editing the file.

If "=" is specified, filename is prefixed with the drive and path of the
current file.

See the SAVE command for the list of valid options.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands
o SAVE command


ΓòÉΓòÉΓòÉ 13.33. FILEFIND (Find Files) ΓòÉΓòÉΓòÉ

Synonym for the LIST command.

Related Information:

LIST


ΓòÉΓòÉΓòÉ 13.34. FILL (Fill Mark) ΓòÉΓòÉΓòÉ

Syntax:  FILL [ character ]

Use FILL to fill the current mark with the character specified.  If no
character is given, a dialog will be presented asking for one.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.35. FINDFILE (Find Files) ΓòÉΓòÉΓòÉ

Synonym for the LIST command.

Related Information:

LIST


ΓòÉΓòÉΓòÉ 13.36. GET (Get a File) ΓòÉΓòÉΓòÉ

Syntax:  GET filespec

Use GET to retrieve a file and insert it starting on the next line after the
cursor position.  The equals sign, "=" can be used for various parts of the
file specifier.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.37. HELP (Open Help Browser) ΓòÉΓòÉΓòÉ

Syntax:  HELP

Use HELP to load the EPMHELP.QHL file into a browse-mode window, which displays
help information.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.38. INSERT_ATTR_VAL_PAIR (Insert Character Attributes) ΓòÉΓòÉΓòÉ

Syntax:  INSERT_ATTR_VAL_PAIR class attr_val [fstline lstline fstcol lstcol
[fid]]

Use INSERT_ATTR_VAL_PAIR in a Rexx macro to insert push and pop attributes as a
pair into a file.  class is the attribute class; attr_val is the attribute
value; fstline lstline fstcol lstcol refer to the beginning and ending
characters where the attributes are to be inserted (if omitted, then a mark
must exist, and the attributes are inserted at the beginning and end of the
mark; for a block mark, at the left and right sides of the mark on each line),
and fid is the identifier of the file into which the attributes should be
inserted (if omitted, it defaults to the current file).

/* Rexx macro to highlight the subject line */
/* Assumes .levelofattributesupport has '1' turned on */
/* to enable color display. */
BLACK = 0; BLUE = 1; GREEN = 2; CYAN = 3; RED = 4; MAGENTA = 5; BROWN = 6;
LIGHT_GREY = 7; DARK_GREY = 8; LIGHT_BLUE = 9; LIGHT_GREEN = 10;
LIGHT_CYAN = 11; LIGHT_RED = 12; LIGHT_MAGENTA = 13; YELLOW = 14;
WHITE = 15; BLACKB = 0; BLUEB = 16; GREENB = 32; CYANB = 48; REDB = 64;
MAGENTAB = 80; BROWNB = 96; GREYB =112; LIGHT_GREYB =112;
DARK_GREYB =128; LIGHT_BLUEB =144; LIGHT_GREENB =160; LIGHT_CYANB = 176;
LIGHT_REDB =192; LIGHT_MAGENTAB =208; YELLOWB =224; WHITEB =240;

'l /Subject:/c'
if rc = 0 then do        /* Found it! */
   'extract /line/col'
   'Insert_attr_val_pair 1' (Light_Magenta + Light_CyanB) ,
                         line.1 line.1 col.1 (col.1 + 7)
end

Related Information:

o Insert_attribute


ΓòÉΓòÉΓòÉ 13.39. INSERT_ATTRIBUTE (Insert Character Attribute) ΓòÉΓòÉΓòÉ

Syntax:  INSERT_ATTRIBUTE class attr_val push_flag offset [col [line [fid]]]

Use INSERT_ATTRIBUTE in a Rexx macro to insert a character attribute into a
file.  class is the attribute class; attr_val is the attribute value; push_flag
is 1 for push, 0 for pop, or the value appropriate for the attribute class
specified. offset is the offset from the character at which the attribute
should be inserted; line and col are the position at which the attribute should
be inserted, and default to the cursor position; and fid is the identifier of
the file into which the attributes should be inserted (if omitted, it defaults
to the current file).

Related Information:

o Insert_attr_val_pair


ΓòÉΓòÉΓòÉ 13.40. KEY (Repeat a Key) ΓòÉΓòÉΓòÉ

Syntax:  KEY #### character

Use KEY to repeat a character horizontally the specified number of times.  This
can be quite powerful;  for example, you can repeat an entire set of recorded
keystrokes (Ctrl+T) 20 times. Example:

KEY 80 =
This writes a line of 80 equal signs into your document.

Character can be a normal ASCII character, or a string representing an extended
ASCII character.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands
o LOOPKEY


ΓòÉΓòÉΓòÉ 13.41. LIST (Find Files) ΓòÉΓòÉΓòÉ

Syntax:  LIST filespec

Use LIST to load a list of file names that match filespec. If filespec includes
a path, then that directory is used as the starting point; if not, the current
directory is used.  Both the starting directory and any subdirectories are
searched for matching files.  This may take a significant amount of time (a
minute or more) if you name a filespec that qualifies an entire hard disk, such
as

list \*.*
 Once you have the list, you can place the cursor on the name of a file, and
then press Alt-1 to edit that file.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.42. LOCATE, L (Locate Text) ΓòÉΓòÉΓòÉ

Syntax: LOCATE or L /searchstring/options

Use LOCATE to find searchstring depending on the options specified:

-
          Searches from the current cursor position backward.
+
          Searches from the current cursor position forward.
M
          Searches within the marked area only.
A
          Searches within the entire file.
C
          Ignores case while searching for searchstring.
E
          Respects case while searching for searchstring.
R
          Search reversed, that is from right to left, within each line.
F
          Search forward, this is from left to right, within each line.
G
          Use the GREP algorithm.

The default options are + A E F.

The delimiter used to separate searchstring, replacestring, and the options is
the first non-blank character following L.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands
o Search dialog


ΓòÉΓòÉΓòÉ 13.42.1. GREP option ΓòÉΓòÉΓòÉ

Use the GREP option, /g, to specify special pattern-matching characters within
the search string. These characters are:

. (period)
          Matches any character.
^
          Matches the beginning of a line.
$
          When following search string, matches the end of a line.
\ character
          Matches character; used to override any special meaning given to
          characters.
[list_of_characters]
          Matches any of the characters in the list.

          A list of characters can be indicated as a range using the hyphen (-)
          For example, [a-z] matches with any letter of the alphabet.  If the
          first character after the [ is a ^, then the set is negated, (because
          it matches any character except those in the set).
*
          Matches a sequence of 0 or more of whatever expression it follows.
+
          Matches a sequence of 1 or more of whatever expression it follows.

Examples are presented that search the following file:

Contents of file junk.e:

soft
good junk
and more
stuff
even good
123456
l
do,re,mi,fa,so,la,ti,do
$35

--------------------------------------

Example searches using GREP:

/l./g
                    Finds "la".

/^good/g
                    Finds only first occurrence of "good".

/good$/g
                    Finds only "even good".

/\$/g
                    Finds "$35".

^[m-t]/g
                    Finds "soft" and "stuff".

/^[^adeg]/g
                    Finds "soft", "stuff", "123456",
                    "l", and "$35".

/^[m-t]+/g
                    Finds "soft" and "stuff".

/^[m-t]*/g
                    Finds everything.

Note:  The above examples are as you would enter them on the LaMail Note
       command line.  When using the Search dialog, you would enter the search
       string (everything between the '/') in the Search field, and select the
       Grep option in the Options section of the dialog.


ΓòÉΓòÉΓòÉ 13.43. LOCK (Lock a File) ΓòÉΓòÉΓòÉ

Syntax:  LOCK [filespec]

Use LOCK to protect the disk copy of the file from other users in a LAN
networking situation.  If a file name is specified, it is loaded and then
locked; if no file name is given, the current file is locked.

The file is unlocked automatically after a FILE or QUIT command, or it can be
unlocked manually with the UNLOCK command.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands
o FILE
o QUIT
o UNLOCK


ΓòÉΓòÉΓòÉ 13.44. LONGNAMES (Toggle Long Names Setting) ΓòÉΓòÉΓòÉ

Syntax:  LONGNAMES [ON | OFF]

Use LONGNAMES to switch the long names setting on or off; anything else tells
you the current value.  When long names is on, a file containing a .LONGNAMES
extended attribute will have the extended attribute value shown on the title
bar when being edited, rather than the actual file name.  This is useful if a
file with a long name is copied from an HPFS drive to a FAT drive and has the
original name saved in .LONGNAME; you will be able to see the long name instead
of the truncated name.  The default is long names mode off.

You must issue this command from the Command window.

To save the current long names mode setting as your permanent default:

 1. Select Options.
 2. Select Save options.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.45. LOOPKEY (Repeat a Key) ΓòÉΓòÉΓòÉ

Syntax:LOOPKEY [#### | ALL] character

Use LOOPKEY to repeat the character in a vertical column.  The character is
typed #### times, proceeding vertically downward in the current column.
(Compare this to the KEY command, which repeats the key horizontally in the
same row.)  The parameter ALL can be used instead of a number, in which case
the repetition continues to the end of the file.

Character can be a normal ASCII character, or a string representing an extended
ASCII character.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.46. LOWERCASE (Convert Marked Text to Lowercase) ΓòÉΓòÉΓòÉ

Syntax:  LOWERCASE

Use LOWERCASE to convert all uppercase alphabetic characters in the marked area
to lowercase.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.47. MARGINS, MA (Set Text Margins) ΓòÉΓòÉΓòÉ

Syntax:  MARGINS or MA [ left [ right [ paragraph]]]

Use MARGINS to set specified values for the margins.  If right or paragraph is
omitted, the default values are as follows:

Omitted   Default Value
right
          The previous right margin value is used for the current value.
paragraph
          The value for left is used for the current value.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.48. MATCHTAB (Use Words as Tab Stops) ΓòÉΓòÉΓòÉ

Syntax:  MATCHTAB [ON | OFF]

If set on, Tab and Shift+Tab use the previous line's columns for the current
line's tab stops.  The previous line's columns are defined by the first
character of each (space-delimited) word.  If no parameter is given, the
current value is displayed.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.49. MATHx (Calculate) ΓòÉΓòÉΓòÉ

Syntax:  MATH|MATHX|MATHO expression

Use MATHx to calculate the value of expression and display the result according
to the command specified:

MATH
          Decimal.
MATHX
          Hexadecimal.
MATHO
          Octal.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands
o MULT


ΓòÉΓòÉΓòÉ 13.50. MESSAGEBOX (Activate Message Box ) ΓòÉΓòÉΓòÉ

Syntax:  MESSAGEBOX [message]

Use MESSAGEBOX to display the editor message box.  If a message is given, it is
added to the message box.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.51. MULT (Multiply Block) ΓòÉΓòÉΓòÉ

Syntax:  MULT

Use MULT to multiply the numeric expressions in the current mark and to display
the result on the next line after the mark.  The mark must be either a block
mark or a line mark.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands
o ADD
o MATHx


ΓòÉΓòÉΓòÉ 13.52. NAME (Rename Current File) ΓòÉΓòÉΓòÉ

Syntax:  NAME filename

Use NAME to rename the file in the editor.  The Name command does not change
the name of the file on the disk.  The new name is used the next time the file
is stored on the disk.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.53. NEWWINDOW (Move Current File to a New Edit Window) ΓòÉΓòÉΓòÉ

Syntax:  NEWWINDOW

Use NEWWINDOW to store the current file if it has been changed, open a new
window containing the file, then quit the file in the current window.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.54. OPATH, OP (Open a File in a PATH Setting) ΓòÉΓòÉΓòÉ

Syntax:  OPATH or OP filespec [pathname]

Use OPATH to search an environment setting for the specified file and load it
into a new window.  The path name defaults to EPMPATH, except if the file
specifier extension is CMD, then the path name defaults to PATH. Examples:

op mycnf.e
          Searches the EPMPATH setting for MYCNF.E.
op test.cmd
          Searches the PATH setting for TEST.CMD.
op main.c include
          Searches the INCLUDE setting for MAIN.C.

The search order is:

 1. The current directory
 2. Each directory listed in the path setting
If the file is found, it is loaded from that subdirectory. If not, it is loaded
without specifying a directory (which defaults to the current directory).

Note:  OPATH is like EPATH, except that it executes an OPEN command instead of
       an EDIT command.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands
o EPATH
o OPEN
o EDIT


ΓòÉΓòÉΓòÉ 13.55. OPEN (Open New Edit Window) ΓòÉΓòÉΓòÉ

Syntax:  OPEN [ [=]file1 ][, [=]file2 ]...

Use OPEN to load the specified files into a new edit window.

If "=" is specified, the file name is prefixed with the drive and path of the
current file.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands
o EDIT


ΓòÉΓòÉΓòÉ 13.56. OS2 (Execute OS/2 Command) ΓòÉΓòÉΓòÉ

Syntax:  OS2 [command_etc]

Use OS/2 to run the OS/2* command processor specified in the COMSPEC
environment variable.  If command_etc is specified, it is passed as an
parameter to the command processor.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.57. PASTE (Paste Text) ΓòÉΓòÉΓòÉ

Syntax:  PASTE [C | B]

Use PASTE to copy text from the clipboard to the editor file at the current
cursor position.  The default is to paste the text as lines (each line in the
clipboard becomes a new line in the file).

C
          The text is pasted as if it were inside a character mark.
B
          The text is pasted as if it were in a block mark (the smallest
          rectangle that would contain all the clipboard text).

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands
o Mark types
o COPY2CLIP
o CUT


ΓòÉΓòÉΓòÉ 13.58. PATH (Show PATH Setting) ΓòÉΓòÉΓòÉ

Syntax:  PATH

Use PATH to open a temporary file containing the PATH environment setting.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.59. PRINT (Print File) ΓòÉΓòÉΓòÉ

Syntax:  PRINT [ printer ]

Use PRINT to print the marked block, if one exists, or the entire file to the
printer specified.  Printer must be PRN, LPT1-LPT9, or a LAN printer name
(\\servername\queuename).  If no printer is specified, the printer used is the
default printer for your system.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.60. PROFILE (Toggle Rexx Profile Support) ΓòÉΓòÉΓòÉ

Syntax:  PROFILE [ON | OFF]

Use PROFILE to switch the profile setting on or off; anything else tells you
the current value.  When PROFILE is on, a Rexx profile (PROFILE.ERX) is
searched for along the EPMPATH and PATH.  If found, it is executed, and passed
the same arguments that EPM was given.  This happens after EPM has processed
the arguments.  The default is profile mode off.

You must issue this command from the Command window.

To save the current profile mode setting as your permanent default:

 1. Select Options.
 2. Select Save options.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.61. QUIT, Q (Quit a File) ΓòÉΓòÉΓòÉ

Syntax:  QUIT or Q

Use QUIT to exit the current file.  If there are more files in the edit ring,
the previous file becomes the current file. If there are no more files, the
edit window closes.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.62. QDATE, QD (Query Date) ΓòÉΓòÉΓòÉ

Syntax:  QDATE or QD

Use QDATE to display the current system date in the form:

  Today is Tuesday March 31, 1992.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands
o QTIME


ΓòÉΓòÉΓòÉ 13.63. QTIME, QT (Query Time) ΓòÉΓòÉΓòÉ

Syntax:  QTIME or QT

Use QTIME to display the current system time in the form:

  The time is 12:00:01 am.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands
o QDATE


ΓòÉΓòÉΓòÉ 13.64. RC (Show Return Code) ΓòÉΓòÉΓòÉ

Syntax:  RC command

Use RC to execute the specified command and display the return code in the
information window.  The command can be either an editor or an OS/2* command.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.65. REGISTER_MOUSE (Register Mouse Event) ΓòÉΓòÉΓòÉ

Syntax:  REGISTER_MOUSE which button action shifts command

Use REGISTER_MOUSE in a Rexx macro to associate a command with a mouse event.
which is 1 for the global mouse table or 0 for the local; button is the mouse
button (1, 2 or 3), action is one of:

Action    meaning

CLICK     Pressing and releasing the mouse button produces a click.

SECONDCLK follows click when the mouse is double-clicked.

BEGINDRAG this is called when the mouse button is depressed and the mouse is
          moved.

ENDDRAG   this is called when the mouse button is released after dragging it.

CANCELDRAG. this is called when the drag is cancelled (by pressing Esc before
          releaseing the mouse button).
shifts is 0 for no shift, or the sum of any combination of 1 for the shift key,
2 for the Ctrl key, and 4 for the Alt key. command is the command to be
executed when this mouse event occurs, or blank if the event should be ignored.

Note:  The standard mouse definitions issue a register_mouse for ENDDRAG and
       CANCELDRAG as part of the BEGINDRAG processing.

/* Register an action for Ctrl+Alt+Double-click MB1 */
'register_mouse 1 1 SECONDCLK 6 rx do_line'

/* Do_Line.erx */
'MH_gotoposition'  /* Move cursor to mouse position */
'extract /line/getline'
if line.1 > 0 then
   getline.1  /* Execute the line as a command */


ΓòÉΓòÉΓòÉ 13.66. SAVE, S (Save File) ΓòÉΓòÉΓòÉ

Syntax:  SAVE or S {option} [[=]filename ]

Use SAVE to store the current file on the disk with the name filename, or using
the current file name if filename is not specified.

If "=" is specified, filename is prefixed with the drive and path of the
current file. option can be any of the following.  If conflicting options are
specified, the last one given is used.

/L
          Save the file in standard OS/2 format - each line should be
          terminated with a carriage return followed by a line feed.
/NE
          Do not add an EOF character at the end of the file.
/NS
          Do not strip trailing spaces.
/Q
          Save quietly; don't give the "Saving" message.
/S
          Strip trailing spaces from each line when saving.
/T
          Converts excess blank characters to tabs.
/U
          Save in Unix format; each line will be terminated with just a line
          feed, and no EOF will be added at the End of File.  This is useful
          when saving files to NFS-mounted drives on an AIX or Unix system.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.67. SAYERROR (Display Error Code or Message) ΓòÉΓòÉΓòÉ

Syntax:  SAYERROR expression

Use SAYERROR to display an error code or message in the message area.

If expression is the number 0 or 1, any pending error messages are discarded
and not displayed.  0 will refresh the screen; 1 will not.

If expression is any number other than 0 or 1, the interpreter displays the
string corresponding to that numbered error message.  Error messages and their
corresponding return codes are listed in the EPM Technical Reference.

If expression is not a number, that text will be displayed on the message line.
This is useful in Rexx macros.


ΓòÉΓòÉΓòÉ 13.68. SET (Show Environment Settings) ΓòÉΓòÉΓòÉ

Syntax:  SET

Use SET to open a temporary file containing all the environment settings.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.69. SHELL (Start EPM Command Shell Session) ΓòÉΓòÉΓòÉ

Syntax:  SHELL

Use SHELL to create an EPM command shell session.  The first time you enter
SHELL in an edit window, two new entries are added to the Command menu.  Create
command shell creates a new shell window, and Write to shell... lets you write
a string to the shell window.  If the shell window is waiting at an OS/2
command prompt, then you can enter a command to be executed by either:

 1. Select Command.
 2. Select Write to shell....
 3. Type the text to be written to the shell.
 4. Select OK.
or

 1. Type the text in the shell window following the prompt.
 2. Press the Enter key.

If the string to be written to the shell is in response to a program prompt,
then you must perform the first sequence; the second method won't write
anything to the shell.

The shell can be used for running any non-fullscreen OS/2 program.  The output
from the program is inserted in the shell window as it is generated, even if
you switch to some other file in the edit ring.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.70. SHOWMENU (Activate Menu) ΓòÉΓòÉΓòÉ

Syntax:  SHOWMENU menuname

Use SHOWMENU to activate the action bar named menuname. Changes made with the
BuildSubMenu and BuildMenuItem commands will not be seen until the updated menu
is displayed with ShowMenu.

Related Information:

o BUILDMENUITEM
o BUILDSUBMENU
o DELETEMENU


ΓòÉΓòÉΓòÉ 13.71. SORT (Sort File) ΓòÉΓòÉΓòÉ

Syntax:  SORT [R][C][I]

Use SORT to sort the lines in the current block or the entire file.  The sort
key is the marked columns.  The options are as follows:

R
          Sorts in reverse (descending) order.
C
          Sorts according to collating order, as indicated by your country and
          code page settings.
I
          Sorts ignoring case.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.72. STAY (Control Cursor Position after CHANGE Command) ΓòÉΓòÉΓòÉ

Syntax:  STAY [ON | OFF]

Use STAY to control the position of the cursor after a CHANGE command.  The
parameters are:

[none]
          Displays current value of STAY.
ON
          Cursor remains in original position after CHANGE.
OFF
          Cursor moves to the last changed string.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands
o CHANGE


ΓòÉΓòÉΓòÉ 13.73. SUBJECT (Display or Set File Subject) ΓòÉΓòÉΓòÉ

Syntax:  SUBJECT

Use SUBJECT to display, set, or change the file subject field.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.74. TABKEY (Toggle TAB Key Action) ΓòÉΓòÉΓòÉ

Syntax:  TABKEY [ON | OFF]

Use TABKEY to switch the tab key mode on or off; anything else tells you the
current value.  When tab key mode is on, the tab key will enter a tab
character.  When TAB key mode is off, the tab key will move the cursor to the
next tab stop without typing in a tab character.  The default is tab key mode
off.

You must issue this command from the Command window.

To save the current tab key mode setting as your permanent default:

 1. Select Options.
 2. Select Save options.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.75. TABS (Set Tab Stops) ΓòÉΓòÉΓòÉ

Syntax:  TABS [ inc | tab1 tab2... tab32 ]

Use TABS to set the tab stops according to the options specified:

inc
          Sets 32 tab stops, beginning with 1, inc spaces apart.
tab1 tab2 ... tab32
          Sets up to 32 tab stops at the specified locations.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.76. TOP (Go To Top) ΓòÉΓòÉΓòÉ

Syntax:  TOP

Use TOP to move the cursor position to the first line of the file.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.77. TRIM (Trim Edit Window) ΓòÉΓòÉΓòÉ

Syntax:  TRIM

Use TRIM to resize the edit window so that no partial characters can be seen at
the right or bottom edge of the edit window.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.78. TYPE (Display or Set File Type) ΓòÉΓòÉΓòÉ

Syntax:  TYPE

Use TYPE to display, set, or change the file type.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.79. UNIVERSAL (Change Universal Variables) ΓòÉΓòÉΓòÉ

Syntax:  UNIVERSAL variable_name [value]

Use REGISTER_MOUSE in a Rexx macro to update some internal universal variables
without having to recompile the macros. variable_name can be one of

default_search_options Options used by the Locate command and initial values
          for the Search dialog.

default_edit_options Options used by the Edit command

default_save_options Options used by the Save command
value is the value to be set in the universal variable, and can be blank. The
value of these variables is inserted before any options passed on the command
line, so these defaults can be overridden on any specific command.

/* Profile.erx - initializations for a new edit window */
      /* Make the default search be case-insensitive */
'universal default_search_options C'
      /* No Tabs - expand them when loading a file */
'universal default_edit_options /nt'
      /* Strip trailing blanks when saving a file */
'universal default_save_options /s'


ΓòÉΓòÉΓòÉ 13.80. UNLOCK (Unlock a File) ΓòÉΓòÉΓòÉ

Syntax:  UNLOCK [filespec]

Use UNLOCK to unlock the current or specified file, which must have been locked
using the LOCK command.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands
o LOCK


ΓòÉΓòÉΓòÉ 13.81. UPPERCASE (Convert Marked Text to Uppercase) ΓòÉΓòÉΓòÉ

Syntax:  UPPERCASE

Use UPPERCASE to convert all lowercase alphabetic characters in the marked area
to uppercase.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.82. VER (Show Editor Version) ΓòÉΓòÉΓòÉ

Syntax:  VER

Use VER to display the version number of the editor.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 13.83. VOL (Show Volume Label) ΓòÉΓòÉΓòÉ

Syntax:  VOL [drive]

Use VOL to open a temporary file containing the volume label of the specified
(or default) drive.

You must issue this command from the Command window.

Related Information:

o Command window
o Issuing editor commands


ΓòÉΓòÉΓòÉ 14. Equals ΓòÉΓòÉΓòÉ

The equals sign, "=", can be used when specifying a new file name to refer the
current file path, file name, and extension, depending on where it appears.
For example, assume the current directory is C:\EDIT, and the current file is
C:\MYDOC\PROG\FOO.DOC.

=
          C:\MYDOC\PROG\FOO.DOC.
=bar.zot
          C:\MYDOC\PROG\BAR.ZOT.
C:\EDIT\=
          C:\EDIT\FOO.DOC.
.\=
          C:\EDIT\FOO.DOC.
=bar.=
          C:\MYDOC\PROG\BAR.DOC.
=.new
          C:\MYDOC\PROG\FOO.NEW.


ΓòÉΓòÉΓòÉ 15. IBM Trademarks ΓòÉΓòÉΓòÉ

Trademark of the IBM Corporation.


ΓòÉΓòÉΓòÉ 16. LaMail Keys Help ΓòÉΓòÉΓòÉ

LaMail's keys fall into the following categories:

o LaMail Main Application Specific Key Help.

   - accelerator keys

o LaMail Note Editor Specific Key Help.

   - Function Key Help.
   - Control Key Help.
   - Alternate Key Help.
   - Cursor and Miscellaneous Key Help.


ΓòÉΓòÉΓòÉ 16.1. Standard Function Keys ΓòÉΓòÉΓòÉ

F1
          Displays help.
F2
          Saves the current file.
F3
          Exits the current file.
F4
          Saves the current file.
F5
          Opens a new edit window.
F6
          Draws in the current file.
F7
          Renames the current file.
F8
          Edits a file.
F9
          Undo.
F10
          Switches between the menu bar and the file being edited.
F11
          Switches to the previous file in the edit ring.
F12
          Switches to the next file in the edit ring.


ΓòÉΓòÉΓòÉ 16.2. Edit Window Keys ΓòÉΓòÉΓòÉ

Alt+F4
          Closes the edit window.
Alt+F7
          Moves the edit window.
Alt+F8
          Sizes the edit window.
Alt+F9
          Minimizes the edit window.
Alt+F10
          Maximizes the edit window.
Shift+F1
          Scrolls the screen left one column.
Shift+F2
          Scrolls the screen right one column.
Shift+F3
          Scrolls the screen down one row.
Shift+F4
          Scrolls the screen up one row.
Shift+F5
          Scrolls the screen so that the line at the current cursor position is
          vertically centered.
End
          Moves the cursor to the end of the line.
Home
          Moves the cursor to the beginning of the line.
PgDn
          Moves the line at the current cursor position forward (down) one
          screen.
PgUp
          Moves the line at the current cursor position backward (up) one
          screen.
Tab
          Moves the cursor to the next tab stop.
Shift+Tab
          Moves the cursor to the previous tab stop.


ΓòÉΓòÉΓòÉ 16.3. Editing Keys ΓòÉΓòÉΓòÉ

Alt+F1
          Inserts a list of various graphic characters at the current cursor
          position.
Alt+A
          Adjusts the mark.
Alt+B
          Marks the current cursor position.
Alt+C (*)
          Copies the marked text.
Alt+D
          Deletes the current mark.
Alt+E (*)
          Moves the cursor to the end of the current mark.
Alt+F (*)
          Prompts you for a character and fills the current mark with the
          specified character.
Alt+J
          Joins the next line with line at the current cursor position,
          separated by a space.
Alt+L
          Marks the line at the current cursor position.
Alt+M
          Moves the current mark.
Alt+N
          Types the current file name at the current cursor position.
Alt+O (*)
          Overlay the current mark.
Alt+P
          Reformats the paragraph, starting at the current cursor position,
          using the current margins.
Alt+R
          Reformats a marked block of text to a new set of margins.
Alt+S (*)
          Splits the line at the current cursor position.
Alt+T
          Centers the text within the current mark (or margins, if no mark).
Alt+U
          Removes the current mark.
Alt+W
          Marks the word at the current cursor position using a block mark.
Alt+Y
          Moves the cursor to the beginning of the current mark.
Alt+Z
          Marks the current character.
Alt+1
          Edits the file name on the line at the current cursor position.
Alt+0
          Executes the line at the current cursor position, or all lines within
          the line at the current cursor position mark.
Alt+=
          Executes the line at the current cursor position, or all lines within
          the line at the current cursor position mark.
Alt+/
          Move to the next bookmark.
Alt+\
          Move to the previous bookmark.
Ctrl+F1
          Converts current word to uppercase.
Ctrl+F2
          Converts current word to lowercase.
Ctrl+F3
          Converts marked text to uppercase.
Ctrl+F4
          Converts marked text to lowercase.
Ctrl+F5
          Moves the cursor to the beginning of the current word.
Ctrl+F6
          Moves the cursor to the end of the current word.
Ctrl+F7
          Moves marked text to the left one column.
Ctrl+F8
          Moves marked text to the right one column.
Ctrl+B
          Activates the List Bookmarks dialog.
Ctrl+C
          Repeats the last CHANGE command.
Ctrl+D
          Erases from the current cursor position to the beginning of the next
          word.
Ctrl+E
          Erases from the current cursor position to the end of the line.
Ctrl+F
          Repeats the last LOCATE command.
Ctrl+I
          Displays the LaMail Note command line.
Ctrl+L
          Copies the line at the current cursor position to the command line.
Ctrl+M
          Activates the Set Bookmarks dialog.
Ctrl+Q
          Switches between the search file and the results of the ALL command.
Ctrl+R
          Starts and stops recording keystrokes.
Ctrl+S
          Activates the Search dialog.
Ctrl+T
          Plays back a set of recorded keystrokes.
Ctrl+2
          Types an ASCII 0 (NUL character).
Ctrl+6
          Types a '╨║'.
Ctrl+9
          Types a '{' (left brace).
Ctrl+0
          Types a '}' (right brace).
Ctrl+Backspace
          Deletes the current line.
Ctrl+Enter
          Moves cursor to the beginning of the next line.  (configurable)
Ctrl+Left
          Moves the cursor to the beginning of the word.
Ctrl+Right
          Moves the cursor to the beginning of the next word.
Ctrl+/
          Character-marks the entire file.
Ctrl+\
          Removes the current mark.
Ctrl+[
          Finds the bracket that matches the current character, taking nesting
          into account.  Matchable characters are (){}[]<> (parentheses,
          braces, brackets, and angle brackets).
Ctrl+]
          Same as Ctrl+[.
Esc
          Displays the LaMail Note command line. (ESCAPEKEY must be on.)
Del
          Deletes the character at the current cursor position.
Ins
          Switches between insert and replace modes.

(*)These definitions will be blocked if the  reftype=hd.CUA Accelerators option
is selected.  Instead, the key will activate the corresponding action bar menu
item.


ΓòÉΓòÉΓòÉ 17. Mark Types ΓòÉΓòÉΓòÉ

There are three types of marked or selected text:  Block, Line, and Character.
Advanced mode uses all three types, while basic mode uses only Character marks.
A detailed description about how to mark or select each type follows:

Block
          A block mark is a rectangular area of text.  To mark a block:

    1. Position the cursor in the upper-right corner of the desired block.
    2. Press Alt+B.
    3. Position the cursor in the lower left corner of the desired block.
    4. Press Alt+B.

       Note:  When you delete a block of text, the text is erased but the space
              that contained the text remains in the file -it is not closed. To
              close the space, you must use a line or character mark to delete
              the text.


Line
          A line mark is a mark of a line or a set of lines.  To mark the line:

    1. Position the cursor in the first line to be marked.
    2. Press Alt+L.
    3. Position the cursor in the last line to be marked.
    4. Press Alt+L.
Character
          A character mark is a mark of a character or set of characters. To
          mark characters:

    1. Position the cursor in the first character to be marked.
    2. Press Alt+Z.
    3. Position the cursor in the last character to be marked.
    4. Press Alt+Z.

Related Information:

Mark Operations


ΓòÉΓòÉΓòÉ 18. Mark Operations ΓòÉΓòÉΓòÉ

There are several mark operations that can be performed.  The most frequently
performed options and their key combinations are listed below:

Alt+A (Adjust Mark)
          Copies the marked text, overlaying the text starting at the current
          cursor position and filling the original text position with blanks.
Alt+C (Copy Mark) (*)
          Copies the marked text to the current cursor position.  The original
          text remains in its position. With line marks, the marked lines are
          copied after the line the cursor is on.
Alt+D (Delete Mark)
          Deletes the marked text from the file.
Alt+E (End Mark) (*)
          Moves the cursor to the end of the mark.  If the mark is a line mark,
          the column position of the cursor is preserved.
Alt+M (Move Mark)
          Moves the marked text from its current position to the cursor
          position, as in the Copy Mark command.
Alt+O (Overlay Mark) (*)
          Overwrites the text at the current cursor position with a copy of the
          marked text.
Alt+T (Center Mark)
          Centers the text within the mark.
Alt+U (Unmark)
          Unmarks any mark within the current ring.
Alt+Y (Begin Mark)
          Moves the cursor to the beginning of the mark.  If the mark is a line
          mark, the column position of the cursor is preserved.

(*)These definitions will be blocked if the  reftype=hd.CUA Accelerators option
is selected.  Instead, the key will activate the corresponding action bar menu
item.


ΓòÉΓòÉΓòÉ 19. Recording Keystrokes ΓòÉΓòÉΓòÉ

With the LaMail Note editor you can record a set of keystrokes to be played
back at a later time.  This is helpful if you are performing a particular
action repeatedly.

To record keystrokes:

 1. Press Ctrl+R to start recording.
 2. Type the keys that you want recorded.
 3. Press Ctrl+R to stop recording.

Press Ctrl+T to playback the recorded keystrokes.

For example, suppose you type DIR to get a directory listing of the current
directory.

 Volume in drive C is MYDISK
 The Volume Serial Number is 0123:4567
 Directory of C:\TCPIP\LAMAIL

ALL          <DIR>      1-01-90  12:01a
ALL      NDX       87   1-01-90  12:01a
OUT          <DIR>      1-01-90  12:01a
OUT      NDX       87   1-01-90  12:01a
PERSONAL     <DIR>      1-01-90  12:01a
PERSONAL NDX       87   1-01-90  12:01a
STUFF        <DIR>      1-01-90  12:01a
STUFF    NDX       87   1-01-90  12:01a
MORESTUF     <DIR>      1-01-90  12:01a
MORESTUF NDX       87   1-01-90  12:01a

You wish to convert all of the file names from the "DIR" format to the
"name.ext" format.

After deleting all lines but the files (not subdirectories) and the file
information (show size, date, and time), you have left:

ALL      NDX
OUT      NDX
PERSONAL NDX
STUFF    NDX
MORESTUF NDX

Place your cursor at the beginning of the first line and press Ctrl+R to start
recording. Press the following keys:

 1. Ctrl+F6
 2. Right "."
 3. Alt+B
 4. Ctrl+Right
 5. Left
 6. Alt+B
 7. Alt+D
 8. Down
 9. Home
10. Ctrl+R
You have recorded the keystrokes to convert one file name.  Now press Ctrl+T
twice to playback the keystrokes, and the files are converted.

There are a total of five files.

ALL.NDX
OUT.NDX
PERSONAL.NDX
STUFF.NDX
MORESTUF.NDX


ΓòÉΓòÉΓòÉ 20. Configuring the Mouse ΓòÉΓòÉΓòÉ

You can configure the mouse in either the basic marking mode or the advanced
marking mode.  The default is the basic marking mode.  In the basic marking
mode, the mark is only usable for deleting text or copying it to the clipboard
Typing any text character deletes the marked text and replaces it with the
entered character.  The basic marking mode mouse actions are:

Button 1 click
          Move cursor position to mouse pointer and unmark.
Button 1 + Shift
          Mark text from cursor position to mouse pointer.
Button 1 click and drag
          Mark text as you drag.
Button 1 double-click
          Move cursor position to mouse pointer and mark the word.

In advanced marking mode, a mark stays until you explicitly delete it or
unmark.  The advanced marking mode mouse actions are:

Button 1 click
          Move cursor position to mouse pointer.
Button 1 + Shift
          Mark text from cursor position to mouse pointer.
Button 1 click and drag
          Block mark text as you drag.
Button 2 click and drag
          Line mark text as you drag. If you start dragging inside a marked
          region, this will instead initiate a drag of the marked text.  The
          text will be moved (or copied, if the Ctrl key is pressed as well) to
          wherever you drop it.
Button 1 + Ctrl + drag
          Character mark text as you drag.
Button 1 double-click
          Unmark text.
Button 1 + Ctrl + double-click
          Ask for help for the token under the mouse pointer.  Looks up the
          word in an index file (EPMKWHLP.NDX, or the file or files listed in
          the HELPNDX environment setting; multiple files must be separated by
          plus signs). Index files are provided by your applications, not as
          part of LaMail.  For example, the OS/2 2.0 Toolkit includes an
          EPMKWHLP.NDX, and the IBM C Set/2 compiler comes with a DDE4.NDX.
          The index file will be looked for in the current directory, along the
          EPMPATH, DPATH, in the directory from which LaMail was loaded, and
          finally along the PATH.
Button 2 double-click
          Move cursor position to mouse pointer and mark the (space-delimited)
          word.
Button 2 + Ctrl + double-click
          Move cursor position to mouse pointer and mark the token according to
          the parsing rules for the C language.  E.g., in the line:

                    s = substr(string, start, end);
          placing the cursor somewhere on string and performing a Button 2 +
          Ctrl + double-click will result in just string being selected, while
          performing a Button 2 double-click will result in substr(string,
          being selected.
Button 2 + Shift + double-click
          Search for the next occurrance of the token under the mouse cursor
          (parsed for the C language, as above).  The search starts after the
          token. The current mark, if any, is not affected.

To select advanced marking mode:

 1. Select Options.
 2. Select Preferences.
 3. Select Advanced marking.

To save the mark mode setting:

 1. Select Options.
 2. Select Save options.

Related Information:

o Mark types
o Mark operations


ΓòÉΓòÉΓòÉ 21. Direct File Manipulation with the File Symbol ΓòÉΓòÉΓòÉ

The File symbol is located in the top left corner of the edit window. It looks
like a sheet of paper with the top right corner folded down. It can be used to:

o Print the visible file.
o Copy a file to another edit window.
o Create another edit window containing your file.
o Copy files to an open file directory folder.

The File symbol is manipulated in the following way:

Select the File symbol by pointing to it with the mouse pointer and pressing
button 2.  Keeping button 2 down, move the mouse pointer over one of the
following:

o An LaMail edit window, to copy the file.
o The LaMail icon, to create another edit window containing your file.
o An open directory, to copy the file to that directory.


ΓòÉΓòÉΓòÉ 22. Help for Search ΓòÉΓòÉΓòÉ

Use this window to search for a string of text or search for and replace a
string of text.

To search for text:

 1. Type the search_string in the Search field.
 2. Select Find to search for text.  Find can be selected multiple times to
    find successive occurrences of the search string.
 3. Select Cancel to close the window.

To replace a string of text:

 1. Type the search_string in the Search field.
 2. Type the replace_string that will replace the search_string in the Replace
    field.
 3. Select either:

   o Change to find the next occurrence of the search_string and change it to
     the replace_string.
   o Change, then find, to do the same as Change, and then search for the next
     occurrence of the search_string after the change has been made.

Note:  The search begins from the current cursor position.  The entire file is
       searched only if the cursor is at the beginning of the first line.

 Related Information:

o Search
o Replace
o Options
o Find
o Change
o Change, then find
o Find, cancel
o Cancel


ΓòÉΓòÉΓòÉ 23. Help for Search ΓòÉΓòÉΓòÉ

Type in the Search filed the text you want to find.  The text you type is
called the search_string.


ΓòÉΓòÉΓòÉ 24. Help for Replace ΓòÉΓòÉΓòÉ

Type in the Replace field the text you want to put in place of the text in the
Search field.  The text in the Replace field is called the replace_string.


ΓòÉΓòÉΓòÉ 25. Help for Options ΓòÉΓòÉΓòÉ

You can choose any of the following options:

Ignore case
          Ignores case in the search_string.  For example, "Search", "search",
          and "SEARCH" are treated the same.
Reverse search
          Searches from the current cursor position to the beginning of the
          file.
Change all occurrences
          Causes all occurrences of the search_string to be overwritten by the
          replace_string.
Marked area
          Searches only the marked text.
Grep
          Searches using the GREP option.


ΓòÉΓòÉΓòÉ 26. Help for Find ΓòÉΓòÉΓòÉ

Select Find to locate the search_string within the current file.


ΓòÉΓòÉΓòÉ 27. Help for Change ΓòÉΓòÉΓòÉ

Select Change to replace the found text with the replace_string.


ΓòÉΓòÉΓòÉ 28. Help for Change, then Find ΓòÉΓòÉΓòÉ

Select Change, then find to replace the first occurrence of the found text with
the replace_string and then find the next occurrence of the search_string


ΓòÉΓòÉΓòÉ 29. Help for Find, Cancel ΓòÉΓòÉΓòÉ

Select Find, cancel to search for the first occurrence of the search_string and
then exit the Search window.


ΓòÉΓòÉΓòÉ 30. Help for Command ΓòÉΓòÉΓòÉ

Use this window to type editor commands.  To enter a command:

 1. Select a command from the selection list or type a command in the entry
    field.
 2. Select OK.

As you type a command, the editor will attempt to match what you're typing with
an existing line in the selection list. At any point you can press Ctrl+O to
select the matched line in the list, or Ctrl+F to find the next matching line.
Ctrl+Backspace will delete the line from the list.

Note:  Commands in the selection list are saved between sessions of the editor.

 Related Information:

o Editor commands
o OK
o Cancel


ΓòÉΓòÉΓòÉ 31. Help for Messages ΓòÉΓòÉΓòÉ

Use this window to display or review error messages.

Select an error message from the selection list to have it displayed in the
entry field. The message can be marked and copied from the entry field to the
clipboard.

Related Information:

o Cancel


ΓòÉΓòÉΓòÉ 32. Help for Describe Error ΓòÉΓòÉΓòÉ

The list displays all errors associated with the current line.  The following
options are available:

Details
          Displays a help panel giving additional information on the error
          message, if this information was provided by the compiler vendor.
Cancel
          Returns control to the edit window.
Help
          Displays this panel.


ΓòÉΓòÉΓòÉ 33. Help for Tabs ΓòÉΓòÉΓòÉ

To set the edit window tabs:

 1. Type the tab settings.  You can type either a single number to use as an
    increment, or you can type a series of numbers separated by a space that
    will be used as column positions.  In both cases, column one is used as a
    starting point.
 2. Select Set or Apply.

For a detailed explanation of each field, select from the list below:

o Set
o Apply
o Defaults
o Cancel


ΓòÉΓòÉΓòÉ 34. Help for Margins ΓòÉΓòÉΓòÉ

Use this window to set the left, right, and paragraph margins.  For each
setting, drag the slider arm, select the left or right slider button, or type a
new value.  Then select Set or Apply.

For a detailed explanation of each field, select from the list below:

o Margins
o Set
o Apply
o Defaults
o Cancel


ΓòÉΓòÉΓòÉ 35. Help for Margins ΓòÉΓòÉΓòÉ

The left and right margins control where the cursor is positioned when typing
text.  If you type beyond the right margin, the word you are typing is moved to
a new line starting at the left margin.

When you reformat a paragraph, it is justified so that all lines are between
the left margin and the right margin, except the first line, which starts at
the paragraph margin.

Related Information:

Reformatting a paragraph


ΓòÉΓòÉΓòÉ 36. Help for Colors ΓòÉΓòÉΓòÉ

Use this window to set the colors used by the editor.  To change colors:

 1. Select a field from the Field selection selection list.
 2. Select the Set background or Set foreground radio button.
 3. Select a color from the Color selection selection list.
 4. Select Set or Apply.

Note:  As you change colors, Sample Text will reflect your changes.

For a detailed explanation of each field, select from the list below:

o Field selection
o Color selection
o Set background
o Set foreground
o Set
o Apply
o Defaults
o Cancel


ΓòÉΓòÉΓòÉ 37. Help for Field Selection ΓòÉΓòÉΓòÉ

Use Field selection to select the field you want to change. The four fields
that you can choose from are:

Text
          Color of normal text.
Mark
          Color of a marked area.
Status
          Color of the status line, if enabled, containing the line and column
          numbers.
Message
          Color of the message line, if enabled, and the color in which
          messages will be displayed.


ΓòÉΓòÉΓòÉ 38. Help for Color Selection ΓòÉΓòÉΓòÉ

Use Color selection to select the color that you want to paint the selected
field.  Select the color you want from the selection list.


ΓòÉΓòÉΓòÉ 39. Help for Set Background ΓòÉΓòÉΓòÉ

Select the Set background radio button to color the background of the selected
field with the selected color.


ΓòÉΓòÉΓòÉ 40. Help for Set Foreground ΓòÉΓòÉΓòÉ

Select the Set Foreground radio button to color the foreground of the selected
field with the selected color.


ΓòÉΓòÉΓòÉ 41. Help for Paths ΓòÉΓòÉΓòÉ

To enter paths:

 1. Type an autosave path.
 2. Type a temporary path.
 3. Select Set or Apply.

For a detailed explanation of each field, select from the list below:

o Autosave path
o Temporary path
o Set
o Apply
o Defaults
o Cancel


ΓòÉΓòÉΓòÉ 42. Help for Paths ΓòÉΓòÉΓòÉ

To enter paths:

 1. Type an autosave path.
 2. Type a temporary path.
 3. Type a dictionary path and file name.
 4. Type a personal dictionary path and file name.
 5. Select Set or Apply.

For a detailed explanation of each field, select from the list below:

o Autosave path
o Temporary path
o Dictionary file
o Personal dictionary
o Set
o Apply
o Defaults
o Cancel


ΓòÉΓòÉΓòÉ 43. Help for Autosave Path ΓòÉΓòÉΓòÉ

The subdirectory in which autosave files are stored.

Note:  If you select a temporary disk, your autosave files will be lost if the
       system loses power while you are updating a file.

Do not select a temporary disk because they only exist until you reboot, and
while power is not interrupted.

Note:  If you do not specify an autosave path, the current directory is used.


ΓòÉΓòÉΓòÉ 44. Help for Temporary Path ΓòÉΓòÉΓòÉ

Use Temporary paths to select the directory where temporary files are created.

This directory should be on a temporary disk, if you have one with room to
spare, both for speed and so you don't have to explicitly erase the files.  A
temporary disk exists only until you reboot, and while power is not
interrupted.

Note:  If you do not specify a temporary path, the current directory is used.


ΓòÉΓòÉΓòÉ 45. Help for Dictionary File ΓòÉΓòÉΓòÉ

Use Dictionary file to specify the path and file name of the file to be used
for spell checking.


ΓòÉΓòÉΓòÉ 46. Help for Personal Dictionary ΓòÉΓòÉΓòÉ

Use Personal dictionary to specify where your personal dictionary addenda
exists or should be created.  Your personal dictionary addenda file is used
during the proof function.


ΓòÉΓòÉΓòÉ 47. Help for Autosave ΓòÉΓòÉΓòÉ

Use this window to control the number of modifications that are required to be
made to a file before it is automatically saved.  Set the number to 0 to turn
off the autosaving feature.

For a detailed explanation of each field, select from the list below:

o Autosave
o Set
o Apply
o Defaults
o Cancel


ΓòÉΓòÉΓòÉ 48. Help for Autosave ΓòÉΓòÉΓòÉ

Use Autosave to specify the number of changes that have to be made to a file
before it is automatically saved.  To specify the number, select the slider
button, drag the slider arm, or type a new value in the field.


ΓòÉΓòÉΓòÉ 49. Help for Fonts ΓòÉΓòÉΓòÉ

To change the editor fonts:

 1. Select Font name.
 2. Select Size.
 3. Select any of the following attributes by selecting the symbol that
    corresponds to the desired feature:

   o Bold
   o Italic
   o Underlined
   o Strikeout

 4. Select Set or Apply.

As you change fonts, Sample Text will change to show you what the font and
attributes look like.

For a detailed explanation of each field, select from the list below:

o Font name
o Size
o Set
o Apply
o Defaults
o Cancel


ΓòÉΓòÉΓòÉ 50. Help for Font Name ΓòÉΓòÉΓòÉ

Use Font name to specify the font you want to use.  Select the arrow to the
right to display the entire selection list; then select the font that you want.


ΓòÉΓòÉΓòÉ 51. Help for Size ΓòÉΓòÉΓòÉ

Use Size to adjust the size of the font.  Select the arrow to the right to
display the entire selection list; then select the font size that you want.


ΓòÉΓòÉΓòÉ 52. Help for Keys ΓòÉΓòÉΓòÉ

To define an action for the Enter key:

 1. Select a key or key combination from the top selection list.
 2. Select an action from the bottom selection list.
 3. Select Set or Apply

For a detailed explanation of each field, select from the list below:

o Set
o Apply
o Defaults
o Cancel


ΓòÉΓòÉΓòÉ 53. Help for Set ΓòÉΓòÉΓòÉ

Select Set to save the settings and have them used every time you open an edit
window.


ΓòÉΓòÉΓòÉ 54. Help for Apply ΓòÉΓòÉΓòÉ

Select Apply to use the selected settings in the current edit window, without
making them permanent.


ΓòÉΓòÉΓòÉ 55. Help for Defaults ΓòÉΓòÉΓòÉ

Select Defaults to set the values to the initial system settings.


ΓòÉΓòÉΓòÉ 56. Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel to close the notebook and discard any changes that were made.


ΓòÉΓòÉΓòÉ 57. Help for Quitting a File ΓòÉΓòÉΓòÉ

Use Quitting a File to end an editing session before a modified file is removed
from the edit window ring.  The following options are available:

Save
          Saves the file as it appears in the entry field.  The file name can
          be modified before Save is selected.
Discard
          Enables the quitting process to continue.  Changes to the file are
          not saved.
Cancel
          Returns control to the edit window.

Note:  When all files have been removed from the edit window ring, the edit
       window is automatically closed.


ΓòÉΓòÉΓòÉ 58. Help for Closing a File ΓòÉΓòÉΓòÉ

Use Closing a File to end an editing session before a modified file is removed
from the edit window ring.  The following options are available:

Save
          Saves the file as it appears in the entry field.  The file name can
          be modified before Save is selected.
Discard
          Enables the quitting process to continue.  Changes to the file are
          not saved.
Cancel
          Returns control to the edit window.

Note:  When all files have been removed from the edit window ring, the edit
       window is automatically closed.


ΓòÉΓòÉΓòÉ 58.1. Help for Proof ΓòÉΓòÉΓòÉ

The Proof window is displayed when a possibly misspelled word is found during
the proof function.  This window contains a list words.  The window buttons are
as follows:

Replace
          The highlighted word from the list is placed inside your document,
          replacing the misspelled word.  The replace function can also be
          achieved by double-clicking on a word in the list.  Replace is the
          default.
Cancel
          Terminates the proof function.
Next
          Skips the highlighted word and continues spell checking.
Temp. Add
          The word that is highlighted is placed in a temporary personal
          dictionary file.  Every other occurrence of that word is considered
          correct during the remainder of your proof session.
Add
          The word that is highlighted is placed in your personal dictionary
          file.  The word is permanently considered correct.
Edit
          Places the word that is highlighted in an entry field, where you can
          modify it.
Help
          Displays this panel.


ΓòÉΓòÉΓòÉ 58.2. Help for Proof Word ΓòÉΓòÉΓòÉ

The Proof Word window is displayed when a possibly misspelled word is found
during the execution of the proof word function.  This window contains a list
box which holds a selection of possible correct words. The window buttons are
as follows:

Replace
          The highlighted word from the list is placed inside your document,
          replacing the misspelled word.  The replace function can also be
          achieved by double clicking on a word in the list.  Replace is the
          default button.
Cancel
          Terminates the proof function.
Add
          The word that is highlighted is placed in your personal dictionary
          file.  The word is permanently considered correct.
Help
          Displays this panel.


ΓòÉΓòÉΓòÉ 58.3. Help for Synonym ΓòÉΓòÉΓòÉ

The Synonym window is displayed if one or more synonyms are found during the
execution of the synonym function.  This window contains a list box which holds
a selection of words.  The window buttons are as follows:

Replace
          The highlighted word from the list is placed inside your document,
          replacing the highlighted word.  The replace function can also be
          achieved by double clicking on a word in the list. Replace is the
          default button.
Cancel
          Terminates the proof function.
Help
          Displays this panel.


ΓòÉΓòÉΓòÉ 59. Help for Undo ΓòÉΓòÉΓòÉ

The number range represents changes made to the current file.  The lower the
number the earlier the change.

To use Undo:

 1. Move the slider to the change that you want to undo.
 2. Select OK.


ΓòÉΓòÉΓòÉ 60. Help for List Ring ΓòÉΓòÉΓòÉ

The selection list contains a list of all files in the current edit ring.

To select a file from the list:

 1. Select a file from the selection list to activate it.
 2. Select Switch to.

Related Information:

o Switch to
o Cancel


ΓòÉΓòÉΓòÉ 61. Help for Switch To ΓòÉΓòÉΓòÉ

Select Switch to to exit the window, and make the selected file the current
file.


ΓòÉΓòÉΓòÉ 62. Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel to exit the window and leave the original file as the current
file.


ΓòÉΓòÉΓòÉ 63. Help for Style ΓòÉΓòÉΓòÉ

Use Style to apply a style, consisting of a specific font, color, or both to a
marked region of text.  You can select an existing style in the Style name
field, or you can define a new style by doing the following:

 1. Optionally, type a new name in the Style name field.
 2. Select Font name.
 3. Select Size.
 4. Select any of the following attributes, if desired:

   o Bold
   o Italic
   o Underlined
   o Strikeout
   o Outline

 5. Select Foreground color
 6. Select Background color to change the background color.
 7. Select Set to apply the selected style to the marked region, or Register to
    register the style and continue in the window.

As you change font and colors, Sample Text changes to show you what the style
looks like.

Note:  If you do not enter a name in the Style name field, you can only apply
       the style to the marked text.  The style will not be registered.

For a detailed explanation of each field, select from the list below:

o Style name
o Font name
o Font size
o Font attributes
o Foreground color
o Background color
o Color selection
o Apply
o Register
o Cancel


ΓòÉΓòÉΓòÉ 64. Help for Style Name ΓòÉΓòÉΓòÉ

Use Style name to select the existing style you want to use, or to enter a new
style name.  Select the arrow to the right to display the entire selection
list; then select the style that you want.


ΓòÉΓòÉΓòÉ 65. Help for Font Name ΓòÉΓòÉΓòÉ

Use Font name to specify the font you want to use.  Select the arrow to the
right to display the entire selection list; then select the font that you want.


ΓòÉΓòÉΓòÉ 66. Help for Font Size ΓòÉΓòÉΓòÉ

Use Font Size to adjust the size of the font.  Select the arrow to the right to
display the entire selection list; then select the font that you want.


ΓòÉΓòÉΓòÉ 67. Help for Font Attributes ΓòÉΓòÉΓòÉ

Select any of the following attributes by selecting the symbol that corresponds
to the desired feature:

o Bold
o Italic
o Underlined
o Strikeout
o Outline


ΓòÉΓòÉΓòÉ 68. Help for Background Color ΓòÉΓòÉΓòÉ

Select the Background color radio button to color the background of the
selected style.


ΓòÉΓòÉΓòÉ 69. Help for Foreground Color ΓòÉΓòÉΓòÉ

Select the Foreground color radio button to color the foreground of the
selected style.


ΓòÉΓòÉΓòÉ 70. Help for Color Selection ΓòÉΓòÉΓòÉ

Use this listbox to select the color that you want to paint the selected style.
Select the color you want from the selection list.


ΓòÉΓòÉΓòÉ 71. Help for Apply ΓòÉΓòÉΓòÉ

Select Apply to use the selected settings on the current text.

Note:  If a name was entered in the Style name field, the style will
       automatically be registered if it did not exist previously.


ΓòÉΓòÉΓòÉ 72. Help for Register ΓòÉΓòÉΓòÉ

Select Register to save the style settings under the name in the Style name
field.


ΓòÉΓòÉΓòÉ 73. Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel to close the dialog and discard any changes that were made.


ΓòÉΓòÉΓòÉ 74. Help for Set Bookmark ΓòÉΓòÉΓòÉ

To set a bookmark:

 1. Type a name in the entry field.
 2. Select Set or Set permanent.

For a detailed explanation of each field, select from the list below:

o Set
o Set permanent
o Cancel


ΓòÉΓòÉΓòÉ 75. Help for Set ΓòÉΓòÉΓòÉ

Select Set to set a bookmark that lasts for the duration of your edit session.


ΓòÉΓòÉΓòÉ 76. Help for Set Permanent ΓòÉΓòÉΓòÉ

Select Set permanent to set a bookmark that is saved with the file and loaded
the next time the file is edited.


ΓòÉΓòÉΓòÉ 77. Help for List Bookmarks ΓòÉΓòÉΓòÉ

To go to a bookmark:

 1. Use the down arrow to the right to display the selection list; then select
    a bookmark.
 2. Select Go to mark.

To delete a bookmark:

 1. Use the down arrow to the right to display the selection list; then select
    a bookmark.
 2. Select Delete mark.

For a detailed explanation of each field, select from the list below:

o Go to mark
o Delete mark
o Cancel


ΓòÉΓòÉΓòÉ 78. Help for Go To Mark ΓòÉΓòÉΓòÉ

Select Go to mark to position the cursor at the bookmark in the current file.


ΓòÉΓòÉΓòÉ 79. Help for Delete Mark ΓòÉΓòÉΓòÉ

Select Delete mark to erase the bookmark from the current file.


ΓòÉΓòÉΓòÉ 80. Adding and Inserting Text ΓòÉΓòÉΓòÉ

When the cursor is in insert mode, the text you type is inserted to the left of
the cursor and no text is overwritten.

To change the cursor to replace mode so that characters in the text are
overwritten:

 1. Position the cursor where you want to begin typing.
 2. Press the Insert (Ins) key.
 3. Type the new characters to overwrite text.


ΓòÉΓòÉΓòÉ 81. Restoring Text ΓòÉΓòÉΓòÉ

To cancel your last action or restore text:

 1. Select Edit.
 2. Select Undo.


ΓòÉΓòÉΓòÉ 82. Finding Text ΓòÉΓòÉΓòÉ

To find or change text in a file:

 1. Select Search.
 2. Select Search.

For additional help, select Help after the window is displayed.


ΓòÉΓòÉΓòÉ 83. Closing Files ΓòÉΓòÉΓòÉ

To close or exit a file:

 1. Select File.
 2. Select Quit.


ΓòÉΓòÉΓòÉ 84. Copying Text ΓòÉΓòÉΓòÉ

You copy text by using the Copy and Paste choices on the Edit menu.

To copy text from one file to another file or to another place in the same
file:

 1. Select the text to be copied.
 2. Select Edit.
 3. Select Copy.
 4. Move the cursor to the point in the file where you want to place this text.
 5. Select Edit.
 6. Select Paste.

Related Information:

Selecting text


ΓòÉΓòÉΓòÉ 85. Deleting Selected Text ΓòÉΓòÉΓòÉ

To delete selected text from a file:

 1. Select the text to be deleted.
 2. Select Edit.
 3. Select Delete mark.

Related Information:

Selecting text


ΓòÉΓòÉΓòÉ 86. Deleting Text ΓòÉΓòÉΓòÉ

To delete text, you can use one of the following:

o The delete (Del) key to delete the character to the right of the cursor. In
  the basic marking mode, the Del key will delete all of the marked text if a
  mark exists.
o The Backspace key to delete the character to the left of the cursor.
o The Ctrl+Backspace key to delete the current line.

Related Information:

Selecting text


ΓòÉΓòÉΓòÉ 87. Marking/Selecting Text ΓòÉΓòÉΓòÉ

To select (mark) text in basic marking mode:

 1. Move the mouse pointer to the left of the first character to be selected.
 2. Press and hold mouse button 1, and then drag the cursor to the right of the
    last character to be selected.
 3. Release mouse button 1.

To deselect text (remove the mark), do one of the following:

o Press mouse button 1 once within the text area.
o Select Edit; then Unmark.

Related Information:

o Mark types
o Mark operations


ΓòÉΓòÉΓòÉ 88. Opening Existing Files ΓòÉΓòÉΓòÉ

To open an existing file:

 1. Select File.
 2. Select Open.

For additional help, select Help after the window is displayed.


ΓòÉΓòÉΓòÉ 89. Entering Text ΓòÉΓòÉΓòÉ

To enter text:

 1. Position the cursor by clicking the mouse button where you want to begin
    typing.
 2. Press Enter to start a new line.
 3. Press the Spacebar to move the cursor to a place where there is no text.
 4. Use the arrow keys or mouse pointer to move the cursor to any area of text.

The cursor moves one space to the right every time you type a character or
press the Spacebar.


ΓòÉΓòÉΓòÉ 90. Pasting or Inserting Text ΓòÉΓòÉΓòÉ

To insert text into a file that you have cut or copied to the clipboard:

 1. Move the cursor to the point in the file where you want to insert the text.
 2. Select Edit.
 3. Select Paste.


ΓòÉΓòÉΓòÉ 91. Joining Lines ΓòÉΓòÉΓòÉ

To join lines, press Alt+J, or (in stream editing mode):

 1. Press the End key to move the cursor to the end of the line.
 2. Press the Del key.

The text from the line below joins the current line at the right of the cursor.


ΓòÉΓòÉΓòÉ 92. Moving Text ΓòÉΓòÉΓòÉ

You move text by using the Copy and Paste choices on the Edit menu.

To move text from one file to another file, or to a different place in the same
file:

 1. Select the text to be moved.
 2. Select Edit.
 3. Select Cut.  This places the text you cut on the clipboard.
 4. Move the cursor to the point in the file where you want to place this text.
 5. Select Edit.
 6. Select Paste.
or, in advanced marking mode, you can press Alt+M to move the marked text
within the current edit window without affecting the clipboard.

Related Information:

Selecting text


ΓòÉΓòÉΓòÉ 93. Splitting Lines ΓòÉΓòÉΓòÉ

To split a line, press Alt+S (assuming the  reftype=hd.CUA Accelerators option
is not selected), or (in stream editing mode):

 1. Position the cursor where you want to divide the text to start a new line.
 2. Press Enter.

The text from the cursor to the end of the line is moved to the next line.


ΓòÉΓòÉΓòÉ 94. Printing Files ΓòÉΓòÉΓòÉ

To print a file:

 1. Select File.
 2. Select Print file.


ΓòÉΓòÉΓòÉ 95. Reformatting Text ΓòÉΓòÉΓòÉ

To reflow the text in the editing area so that any text extending beyond the
margin is moved to the next line:

 1. Position the cursor to the right of the character where you want to start
    reformatting.
 2. Press Alt+P.


ΓòÉΓòÉΓòÉ 96. Saving Files ΓòÉΓòÉΓòÉ

To save a file and continue editing it:

 1. Select File.
 2. Press Save.

If you need help, highlight the Save choice on the File menu and press F1.


ΓòÉΓòÉΓòÉ 97. Naming Files ΓòÉΓòÉΓòÉ

To name a file or change the name of a file:

 1. Select File.
 2. Press Rename.

Note:  This only changes the name within the editor, and does not affect any
       copy of the file previously saved.


ΓòÉΓòÉΓòÉ 98. Issuing Editor Commands ΓòÉΓòÉΓòÉ

To issue or process an editor command:

 1. Select Command.
 2. Select Command dialog.
 3. Type the command.
 4. Select OK.

For additional help, select Help after the window is displayed.

For a complete list of editor commands, select Editor commands below.

Related Information:

Editor commands


ΓòÉΓòÉΓòÉ 99. Setting Margins ΓòÉΓòÉΓòÉ

To set the margins:

 1. Select Options.
 2. Select Preferences.
 3. Select Settings.
 4. Select the Margins tab on the Settings notebook.


ΓòÉΓòÉΓòÉ 100. Help for Open ΓòÉΓòÉΓòÉ

Use this window to open a new edit window, following these steps:

 1. Select the down arrow to the right of the Drive list to display all the
    drives on your system.
 2. Select a drive from the Drive list.
 3. Select a directory from the Directory list.
 4. Type the name of the file in the Open filename field.
 5. Select Open.

Note:  If you do not type a name in the Open filename field, .Untitled will be
       used as the file name.

 For a detailed explanation of each field, select from the list below:

o Open file name
o Type of file
o Drive
o File
o Directory
o Open
o Cancel


ΓòÉΓòÉΓòÉ 101. Help for Add File ΓòÉΓòÉΓòÉ

Use this window to add a file to the current edit window, following these
steps:

 1. Select the down arrow to the right of the Drive list to display all the
    drives on your system.
 2. Select a drive from the Drive list.
 3. Select a directory from the Directory list.
 4. Select a file name from the File list or type a file name in the Open
    filename field.
 5. Select Add.

For a detailed explanation of each field, select from the list below:

o Open file name
o Type of file
o Drive
o File
o Directory
o Add
o Cancel


ΓòÉΓòÉΓòÉ 102. Help for Import Text File ΓòÉΓòÉΓòÉ

Use this window to retrieve a copy of a file and insert it into the current
file, following these steps:

 1. Select the down arrow to the right of the Drive list to display all the
    drives on your system.
 2. Select a drive from the Drive list.
 3. Select a directory from the Directory list.
 4. Select a file name from the File list or type a file name in the Open
    filename field.
 5. Select Import.

For a detailed explanation of each field, select from the list below:

o Open file name
o Type of file
o Drive
o File
o Directory
o OK
o Cancel


ΓòÉΓòÉΓòÉ 103. Help for Open Filename ΓòÉΓòÉΓòÉ

Type the name of the file you want to open in the Open filename field and then
select OK.


ΓòÉΓòÉΓòÉ 104. Help for Save As Filename ΓòÉΓòÉΓòÉ

Type the name of the file you want to save in the Save as filename field and
then select Save As.


ΓòÉΓòÉΓòÉ 105. Help for Type of File ΓòÉΓòÉΓòÉ

Select the down arrow to the right of the Type of file field to display the
available file types.


ΓòÉΓòÉΓòÉ 106. Help for Save File as Type ΓòÉΓòÉΓòÉ

Select the down arrow to the right of the Save file as type field to display
the available file types.


ΓòÉΓòÉΓòÉ 107. Help for Drive ΓòÉΓòÉΓòÉ

The Drive list displays the drives on your system.  Select the drive that
contains the files you want to view.


ΓòÉΓòÉΓòÉ 108. Help for File ΓòÉΓòÉΓòÉ

The File list displays all the files in the directory you selected from the
Directory list.  Select the file you want to open.


ΓòÉΓòÉΓòÉ 109. Help for Directory ΓòÉΓòÉΓòÉ

The Directory list displays the directories on the selected drive.  Select a
directory to display the list of files from that directory in the File list
box.


ΓòÉΓòÉΓòÉ 110. Help for OK ΓòÉΓòÉΓòÉ

Select OK to accept all choices in the window.


ΓòÉΓòÉΓòÉ 111. Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel to remove the window from the screen without saving any changes.


ΓòÉΓòÉΓòÉ 112. Help for Open ΓòÉΓòÉΓòÉ

Use this window to open a new edit window, following these steps:

 1. Select a file from the selection list or type a file name in the entry
    field.
 2. Select OK.

Select File list to view a list of all files.

For a detailed explanation of each field, select from the list below:

o OK
o File list
o Cancel


ΓòÉΓòÉΓòÉ 113. Help for Add File ΓòÉΓòÉΓòÉ

Use this window to add a file to the current edit window, following these
steps:

 1. Select a file from the selection list or type a file name in the entry
    field.
 2. Select OK.

Select File list to view a list of all files.

For a detailed explanation of each field, select from the list below:

o OK
o File list
o Cancel


ΓòÉΓòÉΓòÉ 114. Help for Import Text File ΓòÉΓòÉΓòÉ

Use this window to retrieve a copy of a file and insert it into the current
file, following these steps:

 1. Select a file from the list box or type a file name in the entry field.
 2. Select OK.

Select File list to view a list of all files.

For a detailed explanation of each field, select from the list below:

o OK
o File list
o Cancel


ΓòÉΓòÉΓòÉ 115. Help for Open ΓòÉΓòÉΓòÉ

Select Open to open a new edit window with the selected file.


ΓòÉΓòÉΓòÉ 116. Help for Import ΓòÉΓòÉΓòÉ

Select Import to place a copy of the selected file into the current file.


ΓòÉΓòÉΓòÉ 117. Help for Add ΓòÉΓòÉΓòÉ

Select Add to place the selected file into the current edit window.


ΓòÉΓòÉΓòÉ 118. Help for File List ΓòÉΓòÉΓòÉ

Select File list to display a window that enables you to access files on the
system.


ΓòÉΓòÉΓòÉ 119. Help for Save As ΓòÉΓòÉΓòÉ

Use this window to save a file and assign it a name, following these steps:

 1. Select the down arrow to the right of the Drive list to display all the
    drives on your system.
 2. Select a drive from the Drive list.
 3. Select a directory from the Directory list.
 4. Select a file name from the File list or type a file name in the Save as
    filename field.
 5. Select Save As.

For a detailed explanation of each field, select from the list below:

o Save as filename
o Save file as type
o Drive
o File
o Directory
o Save as
o Cancel


ΓòÉΓòÉΓòÉ 120. Help for Save As ΓòÉΓòÉΓòÉ

Select Save As to store the current file with the name you entered in the file
name field.


ΓòÉΓòÉΓòÉ 121. Help for Print ΓòÉΓòÉΓòÉ

Use this window to print the current file or display a preview of your file
before printing. To print a file as raw ascii text:

 1. Select Raw Ascii text.
 2. Select the printer port (LPT1, for example)
 3. Select Print.

To print a file as formatted text:

 1. Select Formatted text.
 2. Select the print queue.
 3. Set any options desired.
 4. Select Print.

When printing formatted text, you may specify options: which control the layout
and presentation details of the output.  In addition, you can preview: the
formatted pages before spooling them to a printer.

For a detailed explanation of each field, select from the list below:

o Formatted text
o Raw Ascii text
o Queue/port
o Options
o Print
o Preview


ΓòÉΓòÉΓòÉ 122. Help for Raw Ascii text ΓòÉΓòÉΓòÉ

Select Raw ascii to copy raw text to the specified port.


ΓòÉΓòÉΓòÉ 123. Help for Formatted text ΓòÉΓòÉΓòÉ

Select Formatted text to print to the specified print queue.


ΓòÉΓòÉΓòÉ 124. Help for Queue/Port ΓòÉΓòÉΓòÉ

Specify the print destination by selecting the desired queue or port.


ΓòÉΓòÉΓòÉ 125. Help for Options ΓòÉΓòÉΓòÉ

Press Options to display the Print Options dialog.


ΓòÉΓòÉΓòÉ 126. Help for Print ΓòÉΓòÉΓòÉ

Press Print to print to the selected queue or port.


ΓòÉΓòÉΓòÉ 127. Help for Preview ΓòÉΓòÉΓòÉ

Press Preview to view the page formatting before printing.


ΓòÉΓòÉΓòÉ 128. Help for Print Options ΓòÉΓòÉΓòÉ

Use this window to specify details for formatting text for hardcopy.

Fonts used in formatted printing are controlled using the Draft/WYSIWYG
buttons.  In Draft mode, the default printer font will be used; in WYSIWYG mode
the fonts displayed on screen will be used for printing.

Monochrome specifies that that the printing will be black on white regardless
of the colors displayed on screen, while Color causes the printing to respect
these colors (within the limits of the printer being used).

The printer driver Job Properties can be displayed for setting printer-specific
properties by checking the Job Properties box.

Checking Save settings will cause the printer settings and options to be saved
on exit from the print dialog for use when printing is next invoked.

Use Undo to restore the settings to their values when this window was first
displayed.


ΓòÉΓòÉΓòÉ 129. Help for Print Preview ΓòÉΓòÉΓòÉ

Use this window to view the formatted pages before printing.  Upon entering,
formatted pages will be produced in the background and made available for
viewing.  The current page number and total number of pages are displayed in
the upper right area of the window.  '>' and '<' buttons let you move forward
and back through the set of formatted pages.

You can specify whether a given page is to be printed using the Print this page
checkbox.

The lines from your file that are included in the currently-viewed page are
shown at the bottom of the window.


ΓòÉΓòÉΓòÉ 130. Help for Print Mark ΓòÉΓòÉΓòÉ

Use this window to print the currently marked text. To print the marked text:

 1. Select a printer from the list of available printers.
 2. Select Draft or WYSIWYG.

For a detailed explanation of each field, select from the list below:

o Draft
o WYSIWYG
o Cancel


ΓòÉΓòÉΓòÉ 131. Help for Draft ΓòÉΓòÉΓòÉ

Select Draft to print the currently marked text in a draft mode.


ΓòÉΓòÉΓòÉ 132. Help for WYSIWYG ΓòÉΓòÉΓòÉ

Select WYSIWYG to print the currently marked text in the style shown on the
monitor.  WYSIWYG stands for "What You See Is What You Get".


ΓòÉΓòÉΓòÉ 133. Help for Type ΓòÉΓòÉΓòÉ

Use this window to set a type for the current file.

 1. Select a file type from the list of file types.
 2. Select Set.

For a detailed explanation of each field, select from the list below:

o File type
o Set
o Cancel


ΓòÉΓòÉΓòÉ 134. Help for File Type ΓòÉΓòÉΓòÉ

The file type is an attribute of a file that describes its contents.


ΓòÉΓòÉΓòÉ 135. Help for Set ΓòÉΓòÉΓòÉ

Select Set to change the current file type to the type you selected in the
list.


ΓòÉΓòÉΓòÉ 136. Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel if you decide not to change the current settings.


ΓòÉΓòÉΓòÉ 137. Help for Subject ΓòÉΓòÉΓòÉ

Use this window to type a subject for the current file.

 1. Type a line of text (up to 40 characters) that describes the current file.
 2. Select Set.

For a detailed explanation of each field, select from the list below:

o Set
o Cancel


ΓòÉΓòÉΓòÉ 138. Help for Set ΓòÉΓòÉΓòÉ

Select Set to accept the text and close the window.


ΓòÉΓòÉΓòÉ 139. Help for Cancel ΓòÉΓòÉΓòÉ

Select Cancel if you decide not to type a subject.


ΓòÉΓòÉΓòÉ <hidden> Page 3997 ΓòÉΓòÉΓòÉ

Help for REPLY dialog.


ΓòÉΓòÉΓòÉ <hidden> INI file location ΓòÉΓòÉΓòÉ

LaMail stores configuration information in a LAM.INI file. When you start
LaMail for the first time, it will ask you for the location of this file. If
you have a LAM.INI file from a previous release, give the path to it here. If
not, supply the directory where you would like the new one to be created. The
default is C:\OS2, which is where OS/2 keeps its .INI files.


ΓòÉΓòÉΓòÉ 140. Expressions ΓòÉΓòÉΓòÉ

This dialog supports expressions which contain characters with special
meanings:

Character Meaning
.         Matches any character
^         Matches the beginning of a line
$         Matches the end of a line
[         Starts a list (see below)
\         Overrides any meaning associated with a special character.  For
          example:  `\.' means to match a period, instead of any character.

Lists are supported as well.  Lists are just a list of characters, not
separated by anything, that are to be matched.  A list ends with a `]'.
Additionally, the entire list may be negated (i.e. match any character not in
the list), and ranges may be specified by a `-'.

Examples:

[A-Z][a-z] Matches all capital letters followed by a lower-case letter.
^[0-9]    Matches all lines beginning with a digit.
the\.$    Matches all lines ending with the word "the" and a period.


ΓòÉΓòÉΓòÉ 140.1. Search Folders Dialog ΓòÉΓòÉΓòÉ

Use this dialog to look for a particular string through your mail folder(s).

Select folders: Select the folder(s) you want to search.

Select All: This will select all the folders.

Unselect All: This will unselect all the folders.

Search field: Enter a string or an expression to search for in the selected
folder(s).

Case sensitive By checking this option, the search will be case sensitive.

Search index only: By checking this option, LaMail will not search the content
of the notes but only look at the parts of the header cached in the index file
(From, To, Userid, Subject, etc.).

First occurrence only: By checking this option, the search will complete after
the first occurrence is found.

Mark found in folders: By checking this option, LaMail will mark found notes in
the opened folders.

Search button: This searches the specified folder(s) for all occurrences of the
expression specified.  All lines containing at least one match are displayed in
the result box. The match and the sender of the note are highlited.

While the search is in progress, the name of the mail file currently being
searched is displayed at the bottom of the panel.

Stop Search: Selecting this halts the search currently in progress.

Result: This box displays all lines containing matches of the expression. It
also displays the sender of the note.

View:

Clicking on View allows you to view or edit the selected note.  You can also
double-click on a note to view it.

Cancel: Clicking on Cancel exits this dialog box.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

An extended ASCII character can be entered in a KEY or LOOPKEY command as
follows:

a+x
          Alt+X, where "x" is any alphabetic key.
c+x
          Ctrl+X, where "x" is any alphabetic key.
Fn
          Function key N, where "n" is 1 to 12.
x+Fn
          shifted Function key N, where "n" is 1 to 12, and "x" can be "s" for
          Shift, "a" for Alt, or "c" for Ctrl.

In the above, "+" can actually be "+", "-", or "_".  For example:

KEY 10 c-F8


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

An area of computer memory, or storage, that temporarily holds data.  Data in
the clipboard is available to other programs.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

The visual indicator in a slider that shows that the numerical value can be
changed by manipulating it. See also slider.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

A control that represents a quantity and its relationship to the range of
possible values for that quantity.  In some cases, you can change the value of
the quantity.  See also slider arm.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

A family of characters of a given size and style; for example,9-point
Helvetica.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

A symbol that shows that a choice is currently active.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Additional information that the system or a program associates with a file.
The file system or program then uses this information, which is not visible to
you, to recognize the file.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Prints the text to the selected printer using the default printer font.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Prints text using the same fonts as displayed on-screen